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Changed "log-in" to "Log-on" throughout. 


Page l-~1 INTRODUCTION: Added reference to remote file 
"CANDEQUEUE', RELATED DOCUMENTATION: Expanded 
to include CANDE/ANALYZER, HOST/RJE, and SYSTEM/ 
MAKEUSER,. 


2~6 SYNTACTIC VARIABLES: Added notation to indicate 
text string maximum in Text Field section. Added 
"For exceptions...'' to Semantics of Sequence Range. 


3-2 OPERATING PROCEDURES: Updated message display 
information in section (d). 


3-4 SPECIAL CONTROL CHARACTERS: Data Identification 
section updated. 


3-6 FILES: Reference to HOST/RJE product specification 
added to Filename section. 


3-8 SEQUENCE NUMBERS: Added subheading and paragraph 
to describe Sequence Number Zero, 


4~1 thru 4-3 
Added sections entitled; USERCODES AND SECURLT Ys 
STRUCTURE OF THE USERCODE FILE, SYSTEM/MAKEUSER 
EXECUTION, CANDE EXECUTION, and DISK PACK DEFAULTS. 


4-6 WORKFILE: Description of SAVE added to section. 

4-6 thru 4-11 
Added sections entitled: RECORD MODIFICATION, 
LINE DELETION, FILE POSITIONING, DISPLAYS AND ERRORS, 
CRT-~TYPE DEVICES, and SCROLLING, 

4~10 RECOVERY section expanded and updated, 

5-1 Page references deleted from COMMANDS table. 


5-6 CLEAR QUEUE command added. 
DS command moved to Page 5-9 
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con't 5~8 EDIT command deleted. 


5-13 Added BLOCKING to FILES section. 


S14 thru 5-16 
FIND: Explanation of column range added; Text 
option description added, 


5-20 GET: Added description of NOCHECK and CHECK 
options and updated Syntax. 


5-23 thru 5-24 
INSERT; Expanded description of sequence number 
range, . 


5-25 Option '' ;PAGED " deleted. 
5~28 MARGIN/@; Semantics section updated. 
5-34 thru 5-36 
PAGE syntax and explanation updated in major 


revision of this conunand. 


5-38 RECOVER; Added description and example of the 
PURGE option, and updated the Syntax. 


5m47 SAVE: Added "specifying *'' notation to 
Semantics section. 


5-49 thru 5-50 
SEQ; Added NEXT and END to Syntax. Added 
paragraph to explain the display of existing records. 


5.53 SPATCH command description expanded. 


5-56 thru 5-57 7 
TERMINAL: Expanded to include CONTINOUS and WALT. 


5-57 "Default page sizes" added; PAGE LENGTH, CONTINOUS, 
and WAIT sections added. 


5-60 thru 5-61 
WHAT: Added SOURCE FILE SIZE, TANK & WORKFILFE SIZE, 
“SOURCE PACK LD and PATCH ID to Semantics and Examples. 
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con't 5~63 WRITE command added and ZIP command deleted. 


6—1 thru 6-2 
EXECUTION OF CANDE section updated and expanded. 


6-3 Operators message to CANDE updated and EXAMPLE; 
added. 


6-4 thru 6-6 
Heading OPERATOR COMMANDS added and all information 
in this section updated, 


6-7 SCROLLING: Deleted "or ?=s " from description. 


6-8 thru 6-9 
TERMINAL SECTION list deleted; ‘Sequence Number 
Zero'' subheading and instruction deleted; paragraph 
on 'outnut message control" expanded; REQUEST 
table updated; NDL/LIBRARY list of requests and 
controls (2-10-76) deleted. 
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6-9 thru 6-10 
TERMINATION OF CANDE deleted and CANDE/ANALYZER 
section added. 


7-1 thru 7-2 
NETWORK CONTROLLER: Compilation section expanded 
and updated; "DI" changed to "FST1"; file "F" 
concatenated notation added. Paragraph explaining 
reconnection expanded in Operation Section. 


7-3 MAX BUFFERS and MAX MESSAGES increased in NIF 
declaration; BUFFERSIZE increased in TERMINAL 


SECTION. 


7-5 TERMINAL TCS added to TERMINAL SECTION, 


7-5 thru 7-7 ; 
Updated sections entitled: STATION SECTION, 
LINE SECTION, and FILE SECTION. 


7-9 Updated "Terminal Options" section; added (ESC), 
(CAN), and (SI) control coded; TERMINALTYPE 
information deleted. 
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INTRODUCTION 
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The B81800/1700 CANDE program provides generalized file preparation 
and updating capabilities in an interactives terminat ortented 
environmente The 68130071700 CANDE system has been designed = and 
implemented to canform in its functional behavior to the existing 
Bo700 CANDE systein. 


The B1800/1700 CANDE program runs itn conjunction with the 
B1800/1709 NOL system. The NDL generated network controller 
performs alk the data communication related functions» while CANDE 
performs file updating and text editing functions. CANDE can 
support a4 maximum of sixteen concurrent userse The number of 
Stations defined in the network controtler may be any number 
Limited cantly by NBL constraints. CANDE*s remote file 
C"CANDEQUEUE") is opened by default with ‘number of stations? 
CONST *® )=50 but this value may be modified or file~equated in the 
usual manner. 


A basic usercade-password type of security is available with the 
system. The user togseon with a usercode and password and may 
access any files that are associated with his usercode. A recovery 
system is also provided. 


RELATED DOCUMENTATION 
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NUMBER TITLE 
PeSe 2212 5223 Network Definition Language 
PeSs 2212 5215 NDOL/SLIBRARY 
PeSe 2212 5412 Data Comm Audit 
PeSe 2219 0185 CANDE/ANALYZER 
PeSe 2219 Q136 HOST/RJIE 
PeSe 2219 0162 SYSTEM/MAKEUSER 


1073715 Bi800/1700 NDL Reference Manual 
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SYNTAX SPECIFICATIONS 
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SYNTAX DIAGRAMS 


cn an OP OO OR OP aD eee Ue a A GR ew oD we 


The principle means of displaying CANDE command syntax is the 


syntax diagrams This mathod has been chosen because it affords a 
very concise and Lucid exposition of syntax involving defaults» 
aiternativese and iterations it is rigorous without being 


cumbersome. There are few formal rules to remembers: The basic rule 
is that any path traced along the forward directions of the arrows 
will produce a syntacticatly valid command. The following examples 
illustrate the technique: 


i<~ » <7] 
j { 
P-"ROWMM Peo THE ee BOAT" >GENTLY*°=">D0KNe 27> @ ee ore emomen mews STREAM 
{ | { j j prow enue > {rere re- | 
P-YOUR=i Less sece4 =] Peo>THE bP" >0LD3- eer" >-M ILL =>] 
i H 


pos sows | 


Valid productions of this diagram are: 


ROW THE BOAT DOWNSTREAM 

ROWe RGOWs ROWe YOUR BOAT GENTLY DOWN THE STREAN 

ROWs ROWe ROWe ROW THE BOAT GENTLY DOWN THE OLD STREAM 
ROW YOUR SQAT DOWN THE MILL STREAM 

ROW THE 8BOAT DOWN THE OLD MILL STREAM 


dealt 
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The following conventicn is used to control the number of iterations: 


FL 2 I 8 Ma dae ao laa >MISSOURT 
i i 


4 ] Ce wee ee oe Pp CP ee oo ee i en cr ew oe oe cn f 


' 
PoecennoeensBIG sneer ewesceensenn own | 
i : i 
Jorn ee HIDE teem eee ce ene mon nen | 
! . i 


fem weamam ae SMU DY oo ow oe a a a em ne | 


The “bridge* aver the "i" can be crossed only one times so a 
maximnun of one comma may appear. Valid productions are: 


ACROSS THE MISSOURI 

ACROSS THE WIDE MISSOURI 

ACROSS THE BiG» MUODY MISSOURI 
ACROSS THE MUDDY» WIDE MISSOURI 
ACROSS THE BiG» BIG HISSOURT 
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An “*" associated with the number under the bridge indicates that 
the path must be crossed at least one time. If the previous 
example is changed to the following: 


}¢wow Le oS Oe a en OE EE 8D ND oe es) oe ry wm mes f 


i { 
ACROSS THE see lest ercene rene) BIG eases mawaam many fomwa=>MTSSOURT 
4 { 


peer see we ow mee y RIDE <a) ae so a ewe aD ene we wwe > F 


Joccwenncemenn> MUDDY weer anececennen>] 


Then proper syntax is obtained by crossing the bridge exactiy ane 
time. Valid productions are: 


ACROSS THE B81G= WIDE MISSUURI 
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SYNTAX CONVENTIONS 
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CANDE commands are constructed of Letters, digitse special 
characterse and bianks. Letters and digits are alphanumeric 
characters* alk other nonwblanks are detimiters. Alphanumeric 
characters may be separated into such items as integers» keywords 
and identifiers. ALL integerse keywords and identifiers must be 
entered in upper case characters. 


Keywords 


Upper-case Letters in syntax diagrams indicates keywords which 
appear Literally itn the camamand. In many cases it is 
permissible to abbreviate the keyword by its tnitiai or first 
few tLetterse In the Syntax presentations underscores mark the 
fetters which must appears the rest are optional. 


Blanks 


Blanks in CANDE commands serve to separate syntactic items and 
way appear freely except within certain text fields» where 
they become significant characters. Blanks are optional on 
either side of a delimiter. Whenever one alphanumeric item 


Ckeywords identifiers integers etc.) follows another with ne 
separating delimiters they must he Separated by at Least one 
blank. 


End of statement 


End of statement is indicated by the following notations 


2 ae A eo tm FP ame th SEP ED OP eR EE) te EE? i SO GD OK ES) OE LD CD EL aE OO OD OH OD ED Ne OR fet ae OH! GF AB ss aemaw > | 


Ne 
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SYNTACTIC VARIABLES 
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Lowerecase letters» words» and phrases in the syntax diagrams are 
syntactic variablesr which represent infornation to be supplied by 
the usere A particular variable may represent a single characterr 
a simple construct such as an integer or text strings or a 
relatively complicated construct. Most variables are defined where 
used. Several variables and types of variables which are 
frequentty encountered are defined here. 


Identifier 


An identifier t5 a string of characters used to represent some 
entity» such as a file» or a usercode. Identifters in CANDE 
may vary in tength from one to nine charactersr and are 
composed ‘of characters and digits: only» with the first 
character being a non«integer. ; 


Integer 


An integer ts specified by a string of digits which represent 
the decimat value of the integer. Syntactic variables of this 
type occur fregueantiy in CANDE.’ Some common examples are <s> 
(sequence number)e <col> Ccolumn numberds and <base> and <inc> 
(sequence base and increment). 


Delimiters 


The delimiters may be any nonwalphanumeric character except one 
that occurs in the field being delinited or ane that might 
have special meaning in the context of its appearancer these 
instances are detailed with each use of <delim>. CNOTE: 7." 
CPERTOD) is not considered a delimiter). 
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Text Fields 


A text fields denoted by <text> or <newtext>,. is a sequence of 
characters to be sought or placed in a file. In most text 
fieidss aii characters are significant and any character may 
appear except a specific delimiter. A maximum of 30 characters 
may be referenced in a text string. 


sequence Range 


A <sequence range> specifies an inclusive range of sequence 
numoers which define a line or tines ta be itneluded Cor 
excluded) in a particular operation. 


Syntax: 


! : I 
I i 


Semantics? 


The tntegers <Si> and <S$2> represent sequence numberse If both <S1> 
and <¢S$2> appears the sequence range inctudées path those values and 
alt vatues betweens <S2> must exceed <Si*. If <Si> appears alone>s 
it usually defines a range comprising that singie numder. For 
exceptions see the individual command descriptione The keyword 
"PEND » in place of <S2> represents the Largest sequence number tn 
the file. 
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Column Range 


A column range specifies an inclusive range of columnse 
defining a portion of a lines 


Syntax: 


i i 
jwron> col 2> we wD on ee we nD Gn os os aT en en wy § 


Semantics: 


The integers <col 1> and <col 2> represent positions on a tlinee If 
both appearr <col 2> must exceed <cot 1>5 and they define the 
group of columns including both and alt between. If <col 11> 
appears alonese it defines a range comprising that single column. 


Logical Station Number 


The Logical station number <isn> is an unique integer reference 
assigned by the DAYACOMM system ¢o each station in the 
DATACOHM network. This value is normally used when CANDE 
commands pertain to stations. 
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OPERAYING PROCEDURES 
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Before a user can make use of the system capabilities» he must 
first present to the system his usercode and password. If the user 
is using a hardcopy device such as a teletypes the password may de 
typed into an area that the teletype has blacked out. For screen 
devicess a similar degree cf password security may be obtained by 
turning down the screen brightness before entering the password. 


CANDE checks the users identification against the system's file of 
authorized users. If the usercode/password entered is not corrects 
the user is informed and asked to reventer the information. If the 
usercode/password is correct» CANDE responds with an appropriate 
message and considers the station to be a valid user. Yhe user 
Cannot use the system until a successful lLogeon has occurred. 


Log70n 


The user may Logzon to the system in any ane cf three ways. He may 
simpty enter his usercode and password and thus get logged-on. He 
may enter HELLO <usarcode><password> anda be lLogged-on or he may 
enter HELLO and the system will Lead the user through the toeg-on 
sequencee 


i aa 
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The logvon sequence consists of the following steps: 


ae The system sends the fotlowing: 
ENTER USERCODE PLEASE. 


The user should respond by entering his usercodes either by 
itself or followed by a blank and his passworde 


De If the user enters a usercode but not passwords» the system 
them responds with: 


ENTER PASSWORD PLEASE. 


For hardcopy terminal devices» the system then blocks out 
ten characters on the text tine into xhich the user should 
enter his passworde 


Ce If the system recognizes the usercode and passworde if 
preceeds to Step d. If it does not recuygnize the usercede 
and password it displays: 


SECURTTY ERRORs ENTER USERCODE PLEASE. 


and the logon procedure begins again. 


de On successful log-ons the system displays to the user the 
following: 


“BLS8QO/BL760 CANDE MARK <RELEASE> VERSION 
<PATCH LEVEL> C<COMPILE DATE & TIME>) 

USER <usercode> LOGGED“ON AT <time><cdate> 
YOU ARE AT STATIGN <LSN> C<TERMINAL TYPE>)} 
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Qe }f the user*s previous sesston had been aborted due toa 
system failure or dine disconnects» CANDE informs the user 
anpout his recovery fite by displaying the fottowing message: 


PRECOVERY DATA <workfile nane> <date>" 
Wheres 


<workfile name> is the name of the recovered file. 
<date> ¥s the date of the CANDE session recovered. 


Recovery of the indicated workfiile is achieved by responding 
with the RECOVER command. 
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ENTERING DATA 
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Data and commands are entered in the form of messages from the 
keyboard of the terminal. 
SPECIAL CONTROL CHARACTERS 
The following special characters are supported by CANDE: 
FOR ‘ USE 
engrofemessage CEYX) control-C or carriage return 
backspace teftrvarron 
line delete rubout or controle 
Data Identification 
If a message begins with N decimal digits» where N = sequence 
fieid t€ength of the workfiles tt is assumed to be a data 
record and #s added to the workfites otherwise it is treated 
as a command. 
CANDE Commands 
The commands used to create and save filesr ta enter data and 


to perform editing functions are 367065 CANDE compatible 


commands. These tnouts are processed in serial orders» and 
queued if they cannot be immediately executed. 


are 


3°5 


BURROUGHS CORPORATION COMPANY CONFISENTE&AL 


COMPUTER SYSTEMS GROUP B1800/170)3 CANDE 
SANTA BARBARA PLANT PeS. 2212 5561 (8) 


Cantrol Commands 


Control commands are a separate class of input messages 
preceded by the control command character (2). These commands 
provide capability of controlling and interrogating the user's 
operating environment as explained in a Later chapter. Note 
that these commands are processed immediately and are nat 
queued behind other commands from the terminal. 


RESPONSES 


CANDE wiil respond to every command input by the user. ALL commands 
Hill recéive appropriate textual output as a response except for 
single-Line entriese which wilt receive only a si Saad as 
acknowledgement. 
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A file is a collection of records of information. It 
by which the user establishes continuity between one 
between CANDE and ether programs. 


means 
session and the next or 


Filename 
A filename is used to 
SySteme 
the file.idr 
less with 
adds the usercod¢ 
<usercode*/fileeid>. 


to form 


The user may access any file 
specifying the 
files 
thise 
file 

packs 
<file.eid> 
and highere 

specification 
usercodes. 


betng requested. Alsos 


tne user should 


Syntax: 


i 1 
f=--""> usercode/ e272] 


identify a 
When a ftie is created through CANDE 
an alphanumeric identifier of nine characters or 
the first character being non“numerices 
the 


under 
<file.sid> of the 
belonging to another users in a read onty 
the user must specity the 
users may 

or user cartridges by specifying 
or <usercade>/<file.id>. 
refer 
regarding greater detail 
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is the primary 
CANDE 


the B1800/1700 
the user supplies 


fite in 


CANDE 
1eCep 


and 


complete filenames 


by 
may 
mode. 


simply 
access 
To deo 
<usercode>/<file.id> of the 
access files on user 
ON <pack-id> after the 
releases of Viel CANDE>s 
the HOST/RJE preduct 

in file naming with 


usercede 
The user 


his 
file. 


For 
to 
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I t 
P«~--> ON == packe~id “7 
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A user backup file is named <usercode>/fnumber> by defaulte This 
file may be accessed by LIST» WRITE» REMOVE» FILE commands. £9: 
LIST # 5 will cause listing at the terminat of the user's backup 
file named <usercode>/#5. This form of the LIST command can onty 
be interrupted via the 282K command. 


Type 


Possible types which may be specified for a workfile are: 


BASIC DATA MIL RPG ea: 
COU. FORTRAN NDL SDL oOBPL 


The BDASICse COBOLe FORTRANs MiILe NDLe SDBLe and UPL types denote 
files for the respective compilers. A type SE@ ts an arbitrary. 
data file with sequence numberse A type DATA file is ae file 
Without sequence numbers. 
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SEQUENCE NUMBERS 


Files which are edited by CANDE must contain sequence numbers. A 
sequence number is defined as a positive integer cantaining a 
maximum of eight digits which must appear in the input data 
record. The length of the sequence number aust be equal to or less 
than the sequence field width of that file. A sequence number is 
used to identify the line for editing and te specify the pesition 
of the line in the file. Even if the Lines are input out of orders 
CANDE will arrange the lines in ascending ordere Except for BASIC 
files» the sequence numbers are not considered to be a part of the 
data in the file. In BASIC the sequence nunbers are also statement 
numbers . and may be used in statements such as GO YQ. CO80L fiies 
are timited to six digits and are found in the first six columns» 
BASIC files are five digits and are IJlccated in the first five 
columnSe 


RPG is also five digits? they are tocated tin the first five 
-colunnse the rest €Cexcept type DATAcsee BATA filesd are eight 
digits and are found in columns seventy*three through eighty. I[f 
the user is tn doubts he should perform RESEQ command immediately 
after the GET to insure that the fite is properly sequenced. 
Unsequenced files may be sequenced by CANDE. 


Sequence Number Zero 


In both auto sequence and singlevtine entry mode» a sequence number 
zero is accepteds and wiil be the first record of that file. 
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ERROR MESSAGES 


Error m@ssages output by CANDE witl be one or two Lines in tength 
and witt ve self-explanatory. Unrecognized CANDE commands are 
noted as “NO SUCH VERS" errorse 


DATA FILES 
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Files of type DATA are assumed to be eighty characters in tengthe 
with no sequence fieid. [In order to edit files of type BDATAs a 
RESEQ command should be performed tmmediately after toading the 
file. RESEQ will create "pseudo sequence numbers” in colunns 
eighty*three through ninety of the file. The file may then ode 
edited in anormal fashion. The SAVE conmand witli remove the 
"nseudo sequence numbers”. restoring the file to its original 
unsequanced state. 
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CANDE MECHANISHS 
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USERCODES AND SECURITY 
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If executed under a privileged usercode*passwords CANDE uses 


file 


users must be aware of the following items: 


ae 


Usercodes are bracketed by parenthesese and in CANDE®s 
case are Limited to seven characters in tengthse Logon 
is accomplished by entering usercode without 
parentheses. 


Usercodes and passwords may have a pack associated with 
them. [f a pack has been definede CANDE treats tie vack 
as the defautt pack for files. Consequently» all files 
wilt be read or written from this pack. The default may 
be overridden by specifying a pack with the “ON*" 
attribute im CANDE. 


ALL files saved through CANDE are saved as private oar 
pupotic files according to the userts default protection 
specified in the system usercode file. Private files 
can be accessed only by a@ program running under the 
same usercaode the file was saved withe or by running 
with a privileged usercode password. To make a file 
public one must transmit the fotlowing message: ?MH 
<filerid> PIN PUBLIC. 


CANDE has a tworway communication with the MCP eo 
Messages are zipped to the MCP and responses cone back 
to CANDE and are then routed to the requesting usere 
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the 
security mechanisms implemented by the MCP. As a results 


&~? 


COMPUTER SYSTEMS GROUP 81800/1703 CANDE 


EXAMPLES ?WY = gives status of only that user*s job{s). 

?TD ~ gives time and date. 

2?MX ~ gives mix for only that user"s job(s). 

FRE CUC/<fFilename> = removes the file only if the 
usercodes matches i.eer the 
Signed-on ownsr is removing 
one of his/her own files. 

7H0 - modifies only files belonging to that owner. 


ee CANDE Listsr on the terminals printer backup files 
which have been created by jobs executed through CANDE. 
Backup files are Locked in the disk directory with a 
name of the form €usercode)/#<numoer>. The command LIST 
f<number> brings the backup file toa the screen “for 
review. ©f CANDE is not executed under a usercode then 
RJE FILE NAMING» FILE SECURITY» and MCP communication 
are not provided. This means that backup files witl not 
be created automatically nor will they be named as 
aboves 


STRUCTURE OF THE USERCODE FILE 
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The ‘6.1 and later releases of the MCP support a file security 
mechanism for disk files. This means that disk files created py 


running under a -userccde have security restrictions 
enforced on theme These valid userccdes and passwords are 
maintained in the CSYSTEMI/USERCODE file created by 


SYSTEM/MAKREUSERe. For @ more complete discussion of the usercode 
fite and the SYSTEM/MAKEUSER programe see product specification 
2219 O1020 SYSTEM/MAKEUSER. 


SYSTEM/MAKEUSER is a normal-state utility program used to creates 
accessSe or madify (CSYSTEMI/USERCODEs the system usercode file of 
allowabte usercode and password combinations. The information for 
@ach usercode is described below. The fields are termed “usercode 
password entry attributes" and are used to controt the jebs and 
files of users. 
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Field Description 
Usercode ” ? characters 
Password ~ 10 characters 
Packeid ~ 10 characters 


Charge number ~ 2@& bits 
User priority ye 4 bits 
Protection = 2 bits 
Privileged bit bit 


3 
pos 


In the preceding tabler all descriptians 
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Sampie Input 


US=<f characters> 
PW=<10 characters> 
PACK=<10 characters> 
CHG=<6 digits> 
PRI=<2 digitts> 
PUBLIC 

*PRIV 


indicate a maximum tength 


for the inpute *PRIV wilt set the privilege bit in the "an" 


position. 


Each card should contain one Unique usercede-password paire a 


pack,id (blank defaults to system diskdr 


a charge numbers a 


priority numbers and a privilege status indication. The card is in 


free formate with blanks delimiting each 


of usercode=password combinations is 1024. 


denoted by PACK = ”, 


SYSTEM/NAKEUSER EXECUTION 
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item. The maximum number 


A bkank packeid is 


To create the system usercode fite a card deck in the foitowing 


form must be presented to the system: 


EX SYSTEN/MAKEUSER? 
DATA SYSTEM/USER. CODES 


ww) oO 


<usercede entries as defined anove> 


re 


ENDs 


The file will be automatically created> 


Listed» and placed in the 


appropriate name table slot. For more information see PeSe. 2219 


0102. 


uw 
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CANDE EXECUTION 
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To bring up the CANDE system» the user should select fron the 
usercode*password file a public privileged usercode and password 
that do not have a default pack associated with them. This will 
enable CANDE*%s recoverys tanks and workfile to be placed on system 
disk for easter maintenancee To execute CANDE» the user must 


enters 


US <priv>/<user> EX CANDE 


Executing CANDE witt teli the MCP to execute the system handtere In 
Viele a network controller can be placed in the system name table 
and whenever the first request for remote file open cones upp the 
handler. its executed. The network controller is placed in the name 
table by CM C <network controller name>. To request CANDE ta zip 
execute a network controller of the name CANDE/SHANDLERs CANDE must 
be executed with program switch zero set toe one CSHO=1)» as in the 
following example. 


‘US <priv>/<user> EX CANDE SWO=1 


If the controller was executed by the MCP from the *C* stot in the 
Mane tabler and the Last remote file close has been processede the 
NCP will queue a *QC* for the network controller after 3 times 
through "N.SECOND® Cabout Lt minute with a mix of 1) with no 
intervening remote file epens occurring. If the controlter was 
Locked Cexecuted with *PT® or "PROTECTED® or modified thus or 
<MIX>LP was entered) the 'QC" queued by the MCP will be performed. 
Any attempt to OC or OS from the SPO white the handler is ttecked’ 
Will be denied. 


NOTES CANDE may be executed without a usercode/password. If 
this is done CANOE will not provide file security and MCP 
conmunicatione 
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DISK PACK DEFAULTS 
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Since the MCP will force files to a default pack associated with 
the usercode-passwords syntax has been implemented to access fiies 
on system disk if a pack was specified in the usercode-password 
table. The following table applies to ali commands allowing 
filenamess except for SAVE. . 


ENTER | PACK.ID FAMILY.ID FILE.ID 
A DEF ePACK CUC3 A 
A/B A B 
Af38 ON € C A B 
CUCD/A DEF .PACK CUC) A 
CUCO/A ON C . C CUC) A 
eCUCISA CUC) A 
rh A 


No fitle identifier Cincluding * and €)3 may exceed 10 characters» 
CoGep *CASCDEFG) and <ABCDEFGHIJ. Howevers *(ABCOEF GHD. for 
examplee is invalid. 


An asterisk entsred oreceding a filename denotes that the file is 
on system diske and CANDE laoks for a Literal nane following the 
asterisk. To access another user’s filer that file must be changed 
from private to public by the owner or be accessed by a priviteged 
usercode. When saving @ filer tt cannot be saved under someone 
else's usercodee Thus» the command SAVE AS *€UCI/A {5 illegal; 
SAVE AS *A wilt save the file as CUCI“ZA on SyStem disk. A command 
such as SAVE AS A will put the file on disk as <DEF.PACK>/CUCI/A. 
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WORKFILE 


we oe ee Or oy 


CANDE can be directed to read any file which the user may accesse 
howeveres changes may ba mate only to the one file which is catted 
the "workfile". The user gets a new workfile by doing a MAKE» ofr 
he may recall an existing workfile by doing a GET. Additions and 
corrections may be performed on the workfilte by single-lLine 
entries or by using the editing comnands. 


A CANDE workfile consists of two parts. The "trank™ Cwhich is 
invistble to the user) is where additions and edited tines are 
placed until an update takes piace. The “tank* contains a@ maximum 
of 32 entries and if an explicit update has not been issued by the 
time the tank 6 full» an automatic update is done» and the 
contents of the tank are merged with the werkfiles An update 
incorporates all additions and corrections of the work file 
creating a new copy of the workfiile and an empty tanke An update 
dees not make the user*s workfile a permanent file on disk. A SAVE 
is requirad to make the workfile a permanent file and to discard 
the original file. A SAVE creates a new file on disk with an empty 
tank and warkfile. 


The second part of a user’s *"workfile” consists of N ¢# 1 blocks 
Within CANDE*®s master workfile € namad "CANDE/SHORKCFILE*.) N 5 
the number of contiguaus blocks € each 64 records tong ) needed to 
contain att currently changed records including deletes. Notes 
CANDE never writes to a user*s original source fitie. The file is 
only changed at SAVE time. 


RECORD MODIFICATION 
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If a file is praesent €a GETe MAKEr or RECOVER has been processed)» 
the user is assumed to be in a state of editing the fite. Any 
input consisting oniy ef records having vatid sequence numbers 
With no sequence errors will be treated as records to be entered 
into the file. After the input is processed» a NEXT witli be 
performed automaticallye meaning that the next page will be 
displayeds beginning with the record that follows the last one 


anv 
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input. 


PAGE» LIST €except from an external file)s BACKs SAMEs NEXTs er and 
+ explicitly request a page to be disptayed.j For CRT devices» 
records may then be edited and the page Cor partial page) 
transmitted backe For non-CRY devicess the records must ope 
retyped.e 


For recovery purposese CANDE will not clear the screen at tLogton 
time. The user may recover his file and transmit to the system any 
records left on the screen at failure tine. 


The 1920*byte buffer used by the PAGE system has been moved from 
dynamic. memory Cif present) to static memory in CANDE'®s 
haserLimite Lt is used to *rotlin”™ 3a user’s Last outnout in order 
to compare the current input against it. Comparison will allow the 
system to determine if a record has changed so that it will only 
add to the tank those records which nave changed. This 1s 
necessary toa prevent writing unnecessary records to a file when 
the user initiates a SAVE: PATCH. It wilt eaiso make itnput 
processing more efficient. 


Comparison occurs record*by*record only when the sequence numbers 
are the sam@s. If a sequence number 35 encountered in the input 
which does not exist in the tast cutput copye then comparison witl 
cease and the record witl be added. Prosessing will continue itn 
this fashion until either the sequence nunber of an input recerd 
758 oreater than or equal to that of the tast output record at 
which comparison ceases or all inpuc records have been processed. 
This preavents the occurrence of unnecessary error reports or 
"advisories". Aisos synchronization of record coaparison will not 
be toast and ne unchanged records witli be added to the tank. If the 
page of input returned to CANDE is missing any records initiattly 
displayed Cuser has performed a Line delete Locally) the missing 
records are not automatically deleted from the workfile. 
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LINE DELETION 
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Single lines may be deleted through use af the void commande V must 
be the first character of the dine and the line must contain a 
valid sequence number. Any number of blanks» or mone at all, =may 
separate the command and the sequence numbere 


A delete record wilt be queued for later vrocessing and input 
processing will continue. If the sequence number ts in errorse the 


record will be treated as a sequence error (See GENERAL 
CONSIDERATIONS De 

Note? This form of deletion may he time consuming as each 

— deletion request will cause an UPDATE. No 

optimization of successives contiguous Vs (Voids) 


is attempted. 


FILE POSTTIONING 
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CANDE allows the user to move backward and forward throughout the 
filer once PAGE or LIST is tnvokede PAGE or LIST in any form cause 
the file "position”™ pointers C€for BACK» SAMZ»+ NEXTs® ~- or +3 to be 
realLigned to the requested position. For CRY devicess after 
displaying a pager NEXT wilt be written at the home pasition 
Leaving the cursor immediately after ite. Thusse transmission 
without moving the cursor witli effect NEXT autaomaticaily. Any 
other string transmitted in the first Line is treated as a command 
input. If transmission includes nore than the first Liner then it 
is assumed to be input records. The first Line wilf be ignored and 
the input will be processed. 


File positioning is controtled through the following commands: 
BACK <n> $s Display current =<n>th page. 


SAME 2 Display current page again. 
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NEXT <n> & Display current +<n>th page. 

~ > 3 Display page at current ~ <n>th record. 

+ <n> 3 ot aunay page at current i CASEh record. 
Note: A missing <n> implies <n>* equals ona. 


After GET or MAKE or RECOVER» these commands 
CBACKe SAME» . NEXT» “p and +) will be 
operative. 


Plus or minus <n> (4#<n>» “<n>) shift exactly <n> records in the 
direction requestede BACK <n> and NEXYT<n> shift approximately <n> 
pages in the direction requested. In this ways» BACK and NEXT may 
be used to position the file approximateiy to the desired area 
quickly without reading through each record on the way from the 
current position to the requested one» Once in the approximate 
areas the user may adjust the positien accurately by using +t#<n> 
and “<n>. The range of records shifted is 1 <= r <= 131071 where 
r=n for plus and minus and r=n*current pagesize for BACK and NEXT. 


To effect “approximate™ shiftings a factor indicating an estimate 
of the increment between successive sequence nunbers is computed 
at GET time or upon entry of SEQ or RESEG@ command and dynamically 
adjusted for local variation during accumulation of records for a 
display. The initial computation of the factor at GET time will be 
more accurate if *NQCHECK is not specifiade A moving average is 
comouted during sequence checking on the files If <¢NOCHECK ts 
specifieds the factor is computed py dividing the difference 
between the source ending sequence number and the source teginning 
sequence number by the file size. At Si2 or RESEQ times the INC 
(default or specified) is used unless a Sequence range is 
specified indicating Local activity. If sor the factor is not 
modified. 
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RECOVERY 


Recovery of a user's workfile occurs when CANDE is executed after 
an abnormal termination or when the users terminal incurs retry 
consecutive timeouts. The recovery procedure involves creation of 
the recovery file and communication of this fact to the usar when 
the user toags~on.e. Tie recovery file is named <usercois>/ 
RECOVERY“<AB>, <AB> uS a UNique 2-character sequence computed is 
follows: 


<usercode index/36>th character of ATOM (see below} 


A 
8 <cusercode index mod 36>th character of ATOM 


Hou 


ATOM = ASCOEFGHIJKLMNOPQRSTUVHYZ0123455789 
Character 'A* is the Oth character of ATOMS 
Character "9! ys the 35th character of ATOMS 


This scheme produces a uniaue recovery file for each usercode/ 
password pair. To avoid loss of the file upon recoveryr users 
should not intentionally create files named in this manner. 


After tog=on each user that was on the system when it aborted ha 
the option of recovering his workfile. The user enters RECOVER i 
he wishes to get his previous workfile. If the user does not wi 
to recovers he merely starts another sessiaone When a system goers 
Gowne it iS possidte to lose up to four records in the userts tank 
file. 


* 


= =m 
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DISPLAYS AND ERRORS 
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TERMINAL PAGE wilt correctly set page size as requestede See thea 
TERMINAL command section for default page sizes depending on 
terminal type. 


ALL displays to a device having a page size greater than ane wilt 
begin on the second line of the screen and and with the column 
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indicator on the Last Line. 


Any tine whose first token is a valid CANDE command will be taken 
as anew command and executed after the records to that potnt have 
been processed. (Se@ LINE DELETION on page 4°7 for exceptions.) 


ALL numerics tn sequence fields indicate to CANDE that after input 
is processed» the next page should be displayed. 


Sequence errors ara defined as? a) numeric but out of sequence or 
bd} beginning with a nonenumeric which 16 1) not a valid CANDE verb 
and 2) not V (See LINE DELETION). The action taken is to teave the 
screen atone and notify the user on the top Line of the screen. 


Inserts are defined ast numbers in sequence but not put on tne 
screen by CANDE. The action taken is to add the record(s) to the 
tank and te discontinue comparison against the copy until the next 
copy sequence number 15 encountered. 


For devices whose page size equals oner the fatlowing operating 
characteristics are valid: 


~ Break key iteletype only) will clear the output queue and 
terminate. 


” SEQ» when it displays an existing recordr witt CR» 
‘C€CR=Carriage Return)s> LFe and retype the sequence numberr 
leaving ths carriage immediately after the number to allou 
the tine to be changed and re~entered. If onty an ETX or CR 
is returned,» the record wilt not be changed and the command 
will continue. If it was not an existing record (only a new 
sequence number) then returning oniy an ETX oar CR witt 
terminate the command. ; 


- PAGE wilt treat displays as noted above in SEQ. 
= LIST will not be paged but will be continual. 


~ . BACKse SAME» NEXTe @ © and + will be operative. - 


V will not be cperative. 
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CRISTVFE DEVICES 


Pages output to a CRTI=-type device will be preceded by *HOME AND 
CLEAR*® and will have CR appended after the rightmost nonvblank 
character in each line in order to dacrease transmission time 
since the remaining blanks will be deleted. If the Line is blank, 
jt will constst of CR onlyeC(CR = carriage return.) Single tine 
output to a TD820/830 series device will have LC appended to it in 
order to chlear the remainder of the lines (LC=clear toa end of 
Line.) 


STROLLING 


Oh A OC Pm AD 


The NOL Library requests CANDEPQLTD» CANDEFSLTD and CANDESELTO 
contain a scrolling capability available to users running under 
CANDE and those running an apolication program under CANDE. 
Scrotling is disabied by default. Enter "3+" to enable scrotiing 
and *?-" toa disable scrolling. 


ALL output except full page output produced by LIST» PAGE» SEQ is 
written a single line at a time at the bottom of the screen after 
shifting the screen up one tine € the top Line is deleted). Any 
input except paged input is scrotlLed to the bottom of the screen. 
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In the table betows CANDE commands are grouped by function? 


Control Commands: 


BREAK 
DS 
3S 
WHERE 


Editing Commands: 


DELETE 

FIX 

INSERT 
MERGE/RMERGE . 
MOVE . 

PAGE 

RESEA 

SINGLE*LINE ENTRY 


Editing Hode Commands: 


KARGIN/G 
SEQ 


Environment Commands: 


BYE 
DCSTATUS 
FILES 
HELLO 
PASSWORD 
TEACH 
TERMINAL 


Input-Output Commands: 


LIST 
WRITE 


Program Execution: 


COMPILE 
EXECUTE/RUN 


Search Commands? 


FIND 
REPLACE 


Workfile Commands: 


GET 
MAKE 
RECOVER 
REMOVE 
SAVE 
SPATCH 
TITLE 
UPDATE 
WHAT 
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The BREAK command terminates the current output to the terminal. 


Syntax: 


PER oe ee eee © et ce a oe oe ee ee ee ee ee ee ee) 


<break key> 


or MD an 


Semantics: 


ALL ecutput queued for the terminat is 
command is processed. 


"flushed" 


oS BP Cy Ck eR Oe etl ame at MS a et Oe sna > | 


when the BREAK 


2 aa 
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BYE 


The BYE command terminates the user®s current session. 


Syntax: 


RYE Ce ee ee ee ee ee osamaswae > | 


on we 


Semantics: 


A CANDE session is terminated by the BYE commands switched Lines 
mey be disconnecteds If the workfils has nat been saved or 
removeds the user 16 notified vf this conditione The workfilea may 
then be removed or saveéeds and the BYE command revrentered. 


Examoles 


BYF. 
USER <USERCODE> LOGGEO*OFF AT <TIME & DATE> CTIME = <HHSMMSSSIT>) 


Note: Time given is CANDE processor time. (See Appencix) = 
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COMPILE 


eh oh Ge GS OE 


Tne COMPILE command invokes the standard system compilers or any 
nonstandard version. Options provide tne ability to use an 
existing file or workfiles to specify tne. object filenamer to 
specify the compiler namer and tao soecify the Label equation and 
other control statements for both the compile and resultant object 
programe 


Syntax: 


~ 


I 4 J H 
[ Cotes ereconemenmaremeauanoawms | [ Cette wre merc ownan | 
‘ | | i i 
fe" 1 ==> source filename rete >] l->s<> modifier ==>] 
i 1 
=~ 7 => AS object filenamer>] 
} =e i 
in-- 1 ~-> WITH compilernane =~>] 


a A OM MD 


Semantics? 


tf <source filename> is not specifieds then the workfile wilt be 
used as the source fitee If the object filename is not provided», 
then the source filename will be used. In sither casee an "OO" will 
be attached to the end of the file.id to flag the file as an 
object file. 


A compiler must be specified if the source filename given is not 
the current workfile. Also» a compiler should be given tf the 
user's workfile is of a tyne DATA or SEQ. If no compiler is givens 
the UPL compiler will be the default. 


ea 
z 
el 
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Examples 

c 


Compile the workfile using the default compiler type and associate 
the object file with the workfile. 
COMPILE A/S AS D WITH SDL 


Compile the source file A/B as object file <usercode>/0 with the 
SDL comptler. 
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CLEAR QUEUE 


a eD UE CF Eh UT SR We te aR OD 


IES Gy he sae ene eae re SE 8 EE ea So I A es ae NS we a _ wm 
*» 


Causes all pending output to a terminal to be cleared to a maximum 
of "MAX MESSAGES® as defined in the network controller declaration 
sections 


BURROUGHS CORPORATION 


COMPUTER SYSTEMS GROUP 
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DCSTATUS 


ee ee 


The DCSTATUS command orovides general 


status of the userts 


x 


Ssyntaxe: 


OCSTATUS ee ee ee ee ee ee ee ee ee 


en 


DCSTATUS with return to the user a run 


statione 


The following is returned te the user? 


Le LSN 

2. NAHE 

Se TERMINAL TYPE 
4. BUFFER SIZE 

Se MAX RETRY 

Ge INPUT PRIORITY 
7. GQUIPUT PRIORITY 
Be MESSAGE COUNT 


a0¢ 
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information regarding the 


ME UD OM OT 62 Ol ae Ge 41s UY I er Gm ae 6 oD an ap Am Go ew 


down of the user's station. 


Ww 
L 
x 
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DELETE 


2) 6h 8 OM a aD 


The DELETE command discards records fron the workfile. 


Syntax? 


DELETE te ee eee eee tee waa mam > sequence range ee ee ee es i | 


Senantics? 


Those tines specified in the sequence range List are deleted from 
the workfile. If "ALL" is specifieds the entire contents of the 
workfiie is detletede but the nane and other attrisutes are 
preserved. 


Exampless 


DEL ALL 


Delete the entire contents of the workfile. 


DELETE 100°500 


Delete tines 100 through 500 from the workfile. 


DEL 200°END 


DeLete Lines 200 through the end of the workfile. 


BURRDUGHS CORPORATION COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP B1800/1700 CANOE 
SANTA BARSARA PLANT . PaSse 2212 5561 (8B) 
nS 


The DS command DSes Cdiscontinues) the current running user's 
remote program that was executed from CANDE. 


The 0S capability imolemented applies onty to jobs which have 
successfully performed a remote file OPEN. (See og 71d. CANDE 
obtains the mix numoer of the user program and the job may be OSed 
by entering “?DS" from the terminal. Refer to thea ?<MCP CONTROL 
STRING> command for OS*ing jobs which have not opened a remote 
file. 


Syntaxs 


371 
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EXECUTES RUN 


we en de a etd CE OH RA ED ED 


The EXECUTE and RUN cotimands cause executior of an object program? 
the RUN command will provide for compilation of the source file 
prior to execution if the object file is not available. 


oyntaxs 


RUN Dt ot ewe ee OT ROR MD 
- 44 EK Solaheleletetatatetatetetetetatete -i 
} [wcwnene> filename -cse~"$ 1=> 3 +> modifier <-1 
! { 
EXECUTE sss2"4=> $ ==9>] 


Semantics? 


The workfile is assumed if no filename is provided. A 8" is 
specified anly with EXECUTE» and refers to an object fite nat 
created by CANDE. 


filename> in EXECUTE may refer to any file to which the user ts 


A < 
permitted accesses but a <«ftlename> in RUN must refer only ta the 
user's current workfitle. 


Modifier specifications may be provided. 
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Examples: 


EX 


Execute the object program associated with the workfile. 


RUN # FI LINE = REMOTES 


Execute or conpileand~go on the workfile name and Label equate the 
output to the user’s remote terminal. 


wil 


a 
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FYes 


oF 0 oF OH A 


The FILES command provides a method for determining if a file is on 
diske 


Synmtaxs 


PILE Coe Seite ee eR esas es ee eres = filename Wh RN ee AR OS Uw ws OE Ee OD ww ao oe 13 tw oe oe oe > 


ae 11 { 
i----> OBJECT w--> f-> 8 <1 


ee ee) ! => =] 


Semantics: 


The FILES command will search disk for the specified filename and 
report whether ocr not the file is on disk. If the file is presents 
that fact 18s reported along with some generat information about 
the file. The OSJECT parameter allows the user to search for 
object files created through the CANDE COMPILE or RUN comnandse 
(i.@e, the filewid of the specified filenane is changed to 
<file.id> CAT "O6%)}. System object files or object files not 
created through CANOE may be found by using the normal filename 
syntax and omitting tha OBJECT parameter. The "S$" altloaws for 
inquiries on files not created by CANDE. The "** gndicates that 
the file is to be searched for on system disk 


-13 


WS 
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The following is returned to the users terminal when the specified 
file is found on disk? 


FILE <filename> PRESENT 

USERS = <integer> CO0-n) 

TYPE bead <file.type> CCODE» DATAS 66s e Gt lis} 
SIZE = <integer> _ EOF pointer of file) 


BLOCKING CRSZ/RBABALSNAY = Sanhegensd <integer>/ <integer>/ <integer> 
CRECORD SIZE Cbytesd/ 
RECORDS PER GLOCK? 
BLOCKS PER AREAC 
NUMBER OF AREAS) 
CREATED : <date> Cmonth/day/year) 
ACCESSED: <date> {month/day/year) 
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FIND 


ma Cs ab a 


The FIND command searches a file for appearances of specific text. 
Output indicating the result of the search may be directed to the 
terminal. The output ef a FIND is prompt drivene that 8, the 
command with fihi a screen to its page size and then the user must 
transmit a character to get the next page of autpute A "?ORK™ will 
break the output @5 soon a5 possible. 


Symtaxs 


FIND sewceercnaameameuny dolimn esse" > taxt e-s"72"> delim *sc7 > 
cene J er eanucmananame | 

te). ee OG: 4 

{ j 

f= £ = LITERAL «1 


we OR Sh 


a0 Oh On Tm A Oh £ ER EE OO a OO a 0 Po ES Ee Ss ee RD OG) eS ST OT 4 A me se ee ee me as wo ee em om oe oe > | 


{ Al OP oe an 9 Oe FS Ee UA a OP FD Oe Se OY ER Ae a om OR Om Ne ge Un et ED RU ees my EE oe oe } 


Len] eae> fitenage sass sese scales aaa | 
i bece> fyoe oot I 1 
bss. J]. =") SCQGUEnce Tange Shears re sess >| 
I i 
bee 1 "> @ cola range (SF se"> ae eee | 
i 1 
128) {Sees Se. 3 SR eee Ek. eS eeee ese 
i i 
Im->1 er> SFILEee-<filename >i 

i 1 

[mp] 


Semantics: 


Only one target may be sought with a FIND.» The delimiters 
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surrounding the target may be any delimiter. The text may contain 
any characters except the delimiter. The text field may not be 
empty. The text field is treated as a token string unless LITERAL 
is specified. 


The search is successful whenever the string of characters in the 
text field is found in a Line of the file. 


If the integer <count> appearse the search for the associated text 
will be terminated after it has been found tn the specified number 
of times in the fiie. 


If a <filename> is not specified the workfilte is searched by 
default.Specification of <fijilaname> causes searching of the 
specified filer which may be any file the user ts allowed to read. 
A <typa> may be specified te give the Location of sequence numbers 
in relattonship to the taxt. If na <type> is specified and the 
user does not have a workfilers a type af SEQ is assumed. Otherwise 
the file type wilt default to that of the workfile. If a sequence 
range is specified only records falling within that range are 
searched. A column ranger if oprovidede indicates that only a 
specified part of each record is to be examined. Note that a 


column range cannot fali within sequence*number ranger @eqe cals 
7380 for SDL files. 

bt TeEYT 
The eptioné _ TEXY) if specifiede will output the entire Line 
containing the string to the user*s terminals otherwise only the 


sequence numbers of those records containing the string are 
output. The option :FILE <fitlename> will diract output from the 
FIND to a disk file Labeled <usercode>/<filaname>. The user may 
not specify a usercade with this opticne his own usercode is used 
as the muiti=file- name. If the option FILE * <filename> is usedr 
the file is forced to the system disk and not allowed to go ta the 
default pack associated with the usercode (refer to VI.I security 
implementation for CANDE). The defaults for. sequence range and 
,cotumn range are the entire file and the entire record 
respectively. 
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Examples: 


FIND / FILEID ¢ 100-900 


Search the workfile for the occurence of * FILED * within the 100 
through 900 and output any lines found with the text to the 
terminal. 


FIND 10 ¢ STUFF ¢. 
Find the first ten occurences of "STUFF" within the workfite and 


output the sequence number of the records containing the string to 
the terminal. 


AT LE 
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FIX. 


The FIX command atters the contents of a line in the workfile» by 
inserting new text or replacing part of the Line. The alteration 
may be controlled by specifying target texte column numbers» ar a 
compinatione 


Syntax? 


PIX So So Se eee seen eer een ae wena e line texte> Celi nN> newt ex te > 
. 1 1 i ’ 
t=- col 1 =s--- wom eee] Joewonn | 
’ { 
Ie->col 2-<-1 


Semantics? 


The integer <s> is the sequence number of the Line to be modified. 
If there is no such Line tn the filer the command is disregarded. 


The semantics vary for several forms of this commands depending 
upon the presence of celumn numbers and text: 


1. TEXT>» NO COLUMNS: 


The specified Line is scanned fron Left to right for a literal 
appearance of the character string specified as texte When 
Located» the target <text> is replaced by the tharacter string 
specified as “«newtext>. If the target is not founds the FIX is 
disregarded. Only one replacement is made on the Line. 
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Ze TEXTe ONE COLUMN: 


The specified Line is scanned as in lee beginning at col 1. 


3. TEXT» TWO COLUMNS: 


The specified Line is scanned as in ier within the range col 12 
through col 2. 


&4e NO TEXTe NO COLUMNS: 


The newtext is inserted at the beginning of the Line. 


5. NO TEXT» ONE COLUMN: 


The newtext is inserted at the beginning of col 1. 


Be NO TEXTse TWO COLUMNS: 


The characters in columns "col i” through “col 2” are replaced by 
the newtexte 


The <delim> which brackets the target text may be any special 
character. The text may contain any characters except the 
delimiter. Ali characterse including otlanksr are significant in 
the texte the text fietd is empty oniyvy if the two celimiters are 
in adjacent columns. The nexwtext field begins after the second 
delimiter and runs to the end of the record. Blanks are 
Significant. newtext iS empty tf the end of tne record immediately 
fallows the second delimiter. 


If the size of <newtext> is greater than the size of the string 
baing replaced then the data in the record to the right of the 
string being replaced is shifted right to nake roon for <newtext>. 
This may cause overflow. If the size of <newtext> is tess than the 
string being replaced then the data to the right tf the string is 
shifted Left. 


2719 
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There #8 considerable function overlap between the FIX and REPLACE 
commandse FIX is specialized for single reptacements on singte 
Lines and has a very concise syntaxe REPLACE is more generals with 
file-searching and output canpabilitys its various options require 
amore elaborate syntax. 


If a column number outside the text field is specified» or if col 1 
exceeds col 2+ the FIX command is rejected. 


Examples? 


FIX 398 1°39 /AB/ABB 

Locate the target text "AB" within columns 1 through 39 of tine 
398» and replace it with the newtext "ASB". 

FIX 500 /END*ZEND ELSE 

For tine 5904 Locate the text “END"F and replace it with “END 
ELSE". 

FIX 10 49 “/% ADJUST LINKAGE 


Insert nawtexte Z ADJUST LINKAGEe beginning tn column 40 of line 10. 


FIX 2 i°*5 4/7 cand af statement > 


Delete tha first five cotumns of Line 2° shifting the image to the 
Left. 
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GET 


ee ae 40 


The GET command recalls an existing file as the workfile. If the 
unSAVEd workfidle already existss the GET conmand is in error. 


Syntaxs 
GET smn me wy bn ots Doms at filenane ee ee ee > 
= j 3 t { 
[=> @ -| J mame > type 3 ao =D ae EN ER Gn a ar an am eo em > | 
4 } 
ferns 3 eee> NO CHECK o>] 
I Sara i 


Pmm-> CHECK ---e->1 


<= 


Semantics: 


The <filename> may soecify any file ta which the user has access. 
The <usercode>/<filee.id> option gives the user the ability ta get 
a ftte that someone else created» The GET gives the user a capy of 
the file so that he will not alter the original file. The <type> 
specifies the file type of the file being loaded and will dictate 
where the sequence numbers are ptaced in relationship to the text. 
If. <type> is omitted then the file is loaded as a SEG file. If the 


file is Gne that was created by CANDCr the file will be properly 
sequence ds but if the file was not created by CANDE» the user is 
responsibts for sequence errorse If "*" is specifiedr onty the 
literal name after the "*" js Looked for Crefer to VI.1 security 


inplementation for CANDE). 


BURROUGHS CORPORATION © COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP BLe@0Q0/1L700 CANDE 
SANTA BARBARA PLANT P.oSe 2212 5561 (8) 
The options NOCHECK and CHECK provide for performing sequence field .- Ahead 


checking during the get. NOCHECK is the default. (This optiern its 
provided in keeping with previous releases where NOCHECK is the 
only option.» CHECK will perform sequence checking on the file. 
Sequence checking may be terminated early by entering ?BRK (See 
the BREAK command). The file will be marked as tLoaded with no 
errorss Any e@rrors beyond the SREAK wili be detected if read. 


a) 
t 
™~ 
iw 
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If a‘user loads source files to system diske and those files have 
only a single filesnamee that user may now edit those files using 


CANDE. The user enters at his terminal GET 
#EMULTISFILE*ID><FILE’TYPE> and CANDE will toad the file for 
editing. When the file saveds tt will be saved under that user's 


usercocge as “CUSERCODE>/<NAME HE DID THE GET ON>. 


Fxeampless 


GET AFILE 

Get an existing file named AFILE as the workfile. The type will ode 
SEQ. 

GET AFILE FORTRAN 

Get an existing file named AFILE as the uworkfile.s. The type 1s 
FORTRAN. 

GET HIS/NEW UPL 


Get a copy of a file named NEW that belongs to usercode HIS and 
load it as a UPL file. 
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HELLO 


Po 


The HELLO command initiates a new user session without explicitly 
terminating the current session. 


Syntax: 


HELLO Ce ee eee ee ee | 
7 j 2 1 


Semantics? 


The current user®s session #s terminated by tmplicitly performing 
the BYE command and then invoking the nornat logon process to 
initiate the new user®s session. AS with the BYE commande this 
command its in error if the current userts workfile has not been 
saved or removed. If the station ts not currently Logged~one then 
only the normal Log-on procedure ts tnvoked. 


Usercode and password may be included to complete the togvan 
procedure or this information will be requested in the normal 
logron manner. 


> alt aL 
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INSERT 


om 1 oy ce ch oe 


The INSERT command copies records from the workfiler or fron a file 
on diske and places the copies into tha workfile with new sequence 
numbers. 


Syntax: 


INSERT. Se 3=> 41 Lenane= sess Se eeee Sesh ee se RISE SS Ree eR A eee ee ee 
ae I i ! 1 . i ot I 
ence] eeerswrnn>]} I> sequence range =>] In>AT“>basern-=->] 

=< 1 1 

J-4y nc! 


Semantics: 


INSERT copies records from any data file to which the user has 
access oor from the workfile by defaults» and enters them in the 
workfile as a contiguous block. The entire file will be capied iif 
a <filenamea> is specified and tha sequence range List is omitted. 


New sequence numbers are determined by assigning an initial vatue 
to the first Line and incrementing that value for each succeeding 
Line. An integer “<hase> specifies the initial vatue. The incremant 
<inc> for successive sequence numbers in the block may he 
specified as an axplicit integer. If nene appearse the default 
value of 100 is used. 


The range of new sequence numbers may not overlap any {Lines already 
in the files nor may the numbers exceed ths targest sequence 
number which may be expressed in the sequence number field. If the 
format «<filename> or *€usercode)/file~id is usede CANDE wilt Look 
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only on system disk for the file. 


Examples: 


INSERT AY 30004100 

Insert the entire workfile into the workfile starting at 3000-5 in 
increments of 100. 

INSERT AFILE 1007-600 AT 4000 


Insert the lines 100 through 600 from file AFILE into the workfiles 
starting at 4000 and incrementing using the default of 100. 
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LIST 


a 62 a ew 


The LIST command displays the contents of the workfile or some 
other ftle to the user at bis terminal, Options are available for 
selecting specific Lines and columns. 


S¥Ntaxs 


a a a aa a a ae acl aaa | 
~ [irene emma EMU ETA mane s | 

Lae? Soe ee LL eNane: See essen ea nee eS hese aS eS es > 

U Pn> * j Lae Lye ee } 

Ea* (2) Meera > SeQvence Pang = 2 res at SaaS es eases) 

1 | 1 

len lo Steree> 2 COLUuUNn range: 2s Seer ee tee ease sees 4 


Semantics: 


The contents of the workfite are Listed by default. If a ¢filename> 
7506 Specified and if the user has access privileges» the file is 


Listed. If “*" gorecedes the filenamar the default packrtde 
specified in the system usercode file for this userer 15 not 
applied. A <type> may be specifieds sa that sequence numbers can 


be located in relationship to the text. If no <type> 18 given and 
the user dees not have a workfiles a type SEQ is assumed. 
Otherwise the file type given is that of the workfile. 
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A sequence range and a column range may be specifieds otherwises 
the whole file and the entire Line are Listed. Specification of a 
single sequence nunber will disolay that sequenced record onty» 
rather than a page beginning with that record. €Csee “"PAGE") 


Lines output to a terminal have the sequence number on the Left end 
of the record. 7 


Sa) 
s 
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MAKE. 


The MAKE command creates anew workfile. If an unSAVEd workfile 
already exists» the MAKE command is in arror. 


Syntax: 


MAKE ee ee ee ee ee fjile.id nO Oe FS Os ee EE Oe OE ED AD TR OD nT? a eR mA ee wy 

- i j 
Semantics: 

The <filewid> must define a new file within the user*s librarys it 

becomes the name associated with the workfile. A type SEQ file is 


assumed by defautt. The <usercode>/<filew.id> opticn may not be 
used with the HAKE command. 


Examples? 


MAKE AFILE 


Maxe a new workfile with the name AFILE and a default type SEO. 


M AFILE U 


Make a new workfile with the name AFILE and a type of UPL. 


a 8 
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MARGINS 3 


ee 


The MARGIN command controls the entry of text at the teft margin of 
a line by inserting a specified number of blanks in front of the 
data being entered. A margin specification may be in absotute 
column numbers or relative to the previous marginzy it may ode 
effective for all subsaquenc Lines entered at the terminals or for 
a single line. The "a" form must be used ' in automatic sequence 
modes 


“Syntax: 


MARGIN a ee ee ee ee eo | 


See ! i | ! t ! 
wget ee a ow co § J more> 4 men fom am > cok ea ae | jc-o> 3 ox om > entry. somes > J 


Semantics: 


If an unsigned integer “col? appearsr the margin is set to thet 
columns relative to column one at the beginning of the Line. The 
value of <col>. must fall within the text field of the Liner Ce.g.-s 
Should not exceed 72 for UPL files). 


If a signed integer <col> appears» the margin is moved left (-) or 
right +) by the number of colutins specified? the resulting value 
must fail within the text fieid of the Line. 


MARGIN with no other parameters will mow be responded to with 
CURRENT MARGIN=<integer>. 
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If the colon and <entry> are not entereds the new margin 


specification apolies to all Subsequent entries from the terminals 
until anew margin specification is entered or a GET» MAKE is 
performed. If a colon appearse the new margin specification 
applies onty to the single-line entry which follows. 


In automatic sequence modes the “a" must be entered as the first 
character Cafter the system-supnlied sequence number. If the 
colon and <entry> are not entereds the margin specification for 
subsequent entries 15 changede and the sequence number is repeated 
for the next Linee If a colon appearse the subsequent single~tline 
entry %s made at the sequence number providedr the user enters 
only the texte as in any other entry in automatic sequence modee 
Line overflow may occur aS a result of indentation. The user 15 
notified at his terminals and the resulting Line is truncated. 


Examples: 


MAR 203 4700 As=B? 


Enter a Line with Az=8 beginning at column 20 with sequence number 
4700. 


MARGIN¢S 
Change the indentation position te the current starting position 


plus 5 columns and retain this indentation for ait fotlowing 
Inputa 
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MERGE/RMERGE 


The MERGE and RMERGE commands cause a specified filer or -poertions 
thereof» to be merged with the workfiles with the result becoming 
the new workfite.e The two commands differ in precedence 
considerations when arecord in the merge file has the same 
sequence number as arecord in the workfiles: MERGE keeps the 
workfile record and discards the others RHERGE does the reverse. 


Syntax: 
MERGE ee ee mo filename we ch Gr ane eo ae on CE wD GD eR Sequence range a ee ee >j 
ne i i | 1 I 
RMERGE «2 <8 | jr f J ww ee aoe o wom om oe ee ee ee ee saan | 


a oh 


Semantics: 


The <filename> specifies any data file the user is allowed to read 
and “®" gndicates to look only on system diske If a sequence range 
appearsre onty the selected records are merged and the rest of the 
file is ignored. The sequence numbers of records in the merge file 
remain unchanged as they enter the workfite. 
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Exanples: 


MERGE SYMBOL 

Merge the workfile with the complete file SYMBGL» keeping the 
workfiie copy of records with identical Ci.ee. duplicate) sequence 
number se 

RM PATCHES 400*END 


Merge the tines 400 to the end of file PATCHES with the workfiler 
discarding the workfile copy of duplicate sequence numoers. 


i 
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MOVE 


7 ce em 


The MOVE command moves Lines from one point to another within the 
workfiles and changes their sequence numbers. 


syntax? 


; j 
f= since 4 


<a mah es ue i 


Semantics: 


The Lines in the sequence range are deleted after being entered in 
the workfile as a cantinuous block. 


New s@quence mumbers are determined by assigning an tinitial vatue 
<base> to the first Line and incrementing that value for each 
succeeding Line. 


The increment <ine> for successive sequence numbers in the block 
may be specified as an explicit integer. IF none appearse a 
default value of 100 is used. 


The range of now sequence numbers may not overlap any Lines already 
in the filer nor may the number exceed the largest sequence numoer 
which may be expressed in the sequence nunber field. The 
destination may not overlap any existing records in the workfile. 


ie 
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Examples: 


MOVE 100-690 to 9005 


Remove Lines numbered 100 through 600 and reinsert them at 93900» 
905. 910 eee . 


HOVE 1000 to 6000. 


Ramova Line 1000 and insert tit at 6006. 
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PAGE 


mm ee at a 


The PAGE command displays full scereans of information at the 
terninal for editing» and accepts full screens of input from the 
terminal. Operations wilt continue until thea command paraneters 
have been satisfied or the user enters any command on the ton line 
of the terminal. | 


oyntax: 

Ly ee ee ee a Se eee ae ee ee i Rn ee ee ee ee a ee lest at | 

“= i j 
pese< NOK] === Seeee aa a ad el | 
i = . 4 
| i Ao le che hinteleatetetactaineietatekeieieteanadenl 22 oe ms oa ew cn we ee He a ee sf 
i | : i 
powwow Cei) delim text delim s-7er cect seem re “=> 
i ; t 
R reer CL} ONLY Sees ae ER eS eee ee ae ee ee A: 
H I - I 
j fee £Ey LITERAL Sere ae Seren eee ee er ee 
j j = { 
I fe-=- (213 2 column range tert ett eer sewer any 
i ! 
i 


ee €1i) sequence range? Te ee ee ee ee ee > 4 


BURROUGHS CORPORATION 
COMPUTER SYSTEMS GROUP 


SANTA BARBARA PLANT 


delim text delim: 


va 


sequence range: 


LETERAL 


26 


a 

NEXT 3 

Example = 
100 
200 
309 
400 
500 
600 
£90 

Command 


mc a CO a A a 


PAGE ONLY “RKK/ LITERAL 


abcdef 
ghijkk 
Lianopg 
rstuvw 
xyzabed 
efghijkk 
Imnopg 


COMPANY CONFIOENTIAL 
BL S00/1709 CANDE 
PeSe. 2212 5561 (8B) 


scan each record within the 
sequence range for the 
delimited text. Display page 
starting with record in which 
text is found. 
begin at Si» terminate after 
S22 Si alone implies $2 = END. 
Default = BOF-EOF. 
display anly records with 
target texte 
as tn REPLACE» FIND. 
as in REPLACEs FIND. 
resume action requested by 
previous PAGE commande 
Assume page size = 2 and file 
containss 

Response 

Display 200» 600> terminate. 


PAGE 190 Display record 100+ terminate. 

Note: For CRT devicess NEXT is written at the home 
position as in FILE POSITIONING €See page 3-7). 
For ¢t@xt se@archings NEXT means begin searching 
with the next record after the first displayed 
Cif ONLY is not specified) or tast displayed Cif 
ONLY is specified). 
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Note: The meaning of a single sequence number ina 
‘ sequence range specification is now different for 
LIST than it is for PAGE. 


LIST <seqt> will display the single record at 
sequence number <seqt>. 

PAGE <seqi> will display a page of records the 
first of which 3s tha record at 
sequence number ¢«seqi>. 
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PASSWORD 


D> ce Cy UM Bt th me 


The PASSWORD command allows the user to change his password. 
Syntax: 


PASSWORD*~> current password “> new password -"> new passHord=*>] 


a ae OM ee 


Semantics: 


Yo change passwords.» 4a user must enter his current passwordr the 
nm@w passwords and for verification purposes» repeat the new 
password. 
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RECOVER 


oe ah OE ep Co) Oe 


The RECOVER command recalis a recevery file as the workfile. After 
an abnormal termination of CANDE+ those users that were tlLogged-on 
the system will have the option of recovering the workfile on at 
that time. 


Syntax: 


Bl Ve a es eee Eee Se ee ee Te PA Se ee ee eee eee ane 
= , } { 
pow o> s PURGE sm Dare omen > | 


Semantics: 
By entering RECOVER after tlogging~ons thse user can recover his 
work file. 
Example: 
REC 
Recover my previous work file. 
The PURGE aption allows the user to remove a recovery fitle which he 
does not need to recover. 
Exanple: 
RECOVER 2P 


Remove the user's recovery file without recovering. - 
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REMOVE 


2 nT cee im at 


The REMOVE command may be used te remove the workfile or any file 
with the user's usercode. 


Syntax? 


REMOVE wo sere nene talietateatatetetetat wooeee Sn a oreeen>] 

--- i 14 11 i 
{ bin> $1 
fo Uae & mf fowwnnernefileriderecn----->1 
Jm--> OBJECT -ee->) 


Semantics: 


The semantics vary with the form of tie command. 
1. REMOVE 
The workfile is removed. No further editing can be performed until 


a GET or MAKE 18 perfornmede 


2o REMOVE <fite.wid> 


The user’s source file <usercode>/<file~id> is removed. 


32 REMOVE OBJECT 
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The user's object file <usercode>/cworkfile name> CAT "0" 15 
removed. 


he REMOVE OGBUECT <filewid> 


The user’s object file <usercode>/<filesid> CAT "0" is removed. 

5. REMOVE OBJECT & <file.id> 

The usar'’s object file <usercode>/<fileoid> is renoved. 
Exanples? 


REM 


Remove the workfile. 


REMOVE AFILE ON <packeid> 


Removes <usercode>/AFILE from pack <pack.id>. 


REMOVE OBJECT AFILE 


Removes <usercode>/AFILED if the file is of type "CODE". 


REMOVE OBJECT SAFILE 


Removes <usercode>/AFILE if the file is of type "CODE". 
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REPLACE 


cua a oP Ae ee 


The REPLACE command scans tLine-tysline through the workfile or 
selected portions» replacing certain target text with ner text. 
REPLACE i$ also a prompt driven commands outout comes toa the 
terminal after transmission of any character frem the home 
position. A “PBRK® will break the output as soon as passible. 


syntax: 


=a ne J cw ce wane we meme | f j 
11 “> COUNT mPbee->COLUNN=->cal Leas eo. 2e4 
mon 
bo. o°> FIRST ~1 [aonencewmnt 
i wenn | 
fi => LITERAL 


cmne> Hawrext =s=-—=> del fh or tre er eee me wien ee etm ee are mm me ee me ae ms Ryan ee D, 
j t 
Bre oe ae em aes os sso ase KS mm me otf 
} H 
{| 1] *»e => Seqiente raensze «-=--+] 
i . i] 
Pies 3g colugn range ts} 
H i 
§ LP sme3nrwer> STEXT ere ses cen mene sj 


aS ee wm 
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Semantics: 


Oniy one replacenent may be specified in each REPLACE? the 
replacement is defined by a target and a suastituttion. The target 
specification may contain a text field or column numbers? the 
substitution specification always contains a newtext fields which 
can be blankse The <taxt> and <newtext> fields are bracketed ody 
delimiters. The <text> or <newtext> may contain any characters 
except the detimiter. 


TARGET SPECIFICATIONS: 


Ce Ohi Wo GN AB OM 40) GD rat Ge Ge om me HQ OE OD TT Sk ES tk 


The form <COLUMN col 1L> causes the <newtext> te be inserted at the 
colunan specified. The form <COLUMN col 1 = coal 2> means that the 
characters itn columns col 1 through cot 2 are to be replaced ody 
€newtext>. If <text> must be presente and it specifies a tarset to 
pe sought. 


For purposes of the search» all strings are considered to be token 
Stringse Each line of the file is considered as an arbitrary 
string af tokens» excluding blanks. The search is successful 
whenever the string of characters in the text field is found in a 
line of the file. Literal strings must be searched for in LITERAL 
modee 


If the keyword FIRST appearsr only the first appearance of the text 
on any Line is sought and replaced. If an integer <count> appearss 
the replacement will be terminated after the program nas replaced 
<text> with <newtext> the specified <caunt> of times. 
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The replacement may be restricted to a sequence range of the file 
or to a column range of the record. The défaults are the entire 
record length and the entire file. 


If the option <:TEXT> is specifieds the entire record ts output to 
the user's terminal. If <:TEXT> is not specified» onty the 
sequence numbers of records affected by REPLACE are output to the 
terminal. 


SUBSTITUTION SPECIFICATIONS: 


oe Re eT OE OE ee OO oe 8 i GD HE RS ee OH ee Oh) A OR CE ae OF 


whenever a target is founds the <newtext> Cwhich may be blanks? 1s 
substituted. Adjustment for different Length <text> and <newtext> 
is made by shifting the right<«hand end of the tine Cor colunn 
range) to the left or rights deleting or adding terminal blanks. A 
tine overflow error is detected whenever the adjustment would 
shift noneblank characters off the end of the tine for column 
range). ; 


Examples: 


REP / AB # / ABB fF 


Search the entire workfile for the string “AB"™ and replace it with 
"ABB 6 


REPLACE COL i*5 / 4 130180 


Replace the contents of cotumns 1 through 5 in tines 130 through 
160 with empty newtext. 


BURROUGHS CORPORATION | COMPANY CONFIDENTIAL 

COMPUTER SYSTEMS GROUP aT Get iCay CRNDE 

SANTA BARBARA PLANT PeSs 2212 5561 €B) 
RESEQ 


The RESEQ@ command assigns new sequence numbers to tines in the 
workfilee without changing the order in which the lines appear. 


Syntax: 


RESEQ tere tere ener eet ew ene m enn erence nn nn nanan auna anne | 
aa 1 i? it f 
Jnoes GS = => § meet frnnee> base eee} pore=> & inc soo=>I 

Li 2 i 

I-> END -- 


Semantics: 


An initial value is assigned as the sequence number of the first 
Line to be rernumbered? the vatue is ineremented for each 
subsequent line. 


lf arange of sequence numbers is providedse onty the specified part 
of the workfile is rewnumbereds by defaults» the entire workfile ts 
renumbered. 


An initial value must be specified as the integer <base>. The 
increment <inc> for successive new sequence numbers may be 
specifieds if none anpaarse the default value of 100 is assumed. 


RESEQ will not change the appearing order of the linese Sl must be 
less than or equal to <base> and the <pase> ptus the number of 
dines times the <inc> must not exceed S2 # <inc>. 
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Examples: 


RESEQ 200 


The entire workfile 1s renumbered starting with the initial vatue 
of 200 and proceeding in increments of 100. 


RESEG 100-700 100410 


Reseq Lines 100 through 700 starting at 100 and incrementing by 10. 


SAF 
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$5 


ww oy 


The $S command provides the ability to send a message to another 
Station or to the system SPO. 


Syntax: 


“S85 es isn SES GG UT GSD ME CEES EE hin aw Om al en ee HED SD text ES OP Ge Oe OE RH eR eo oH ED ae om Sy 


ome ! 
Pome er ener eens SPD ene ee roe eewen >] 
1 i 
[Sees ee tse se> <usepcodas: -<"-=si451 
.- 4 
[aoectece ce wee> ALL cesses enecen >I 


Semantics: 


The receiving Station may be referenced by <lsn> or by the 
<usercode> of a user if he is logged-on the system. The <text> may 
consist of any character string up to the naximum Line size of the 


sending or receiving terminal. 
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SAVE 


The SAVE command causes the current workfile to be saved. 


Syntaxs 


SAVE 7 8 Oe) ON HP Om SD Sm CO aw On ED Ow nO) ee wo ON Mk SEY mn CD Om eH EY oe OD a SPD OS eR cE oe me ao OT Oe Ce ee ee ee ee ee ee: ow er oe ce } 
aps i $4 1 j 1 
tery AS Hem rn eT Tee 1 Cloth) bas> ON <patketdera4t Pesos Par Ch =a4 
wen J i 7 
for & =] 


=a 


Semantics? 


If no <file.id> is specified» the workfilte its SAVEd under its 
workfile name. The workfile may be SAVEd under a different name by 
using the "AS <fileeid>" option. Specifying “*" wilt override the 
default pack and save tha file on the systen disk. 


The tPATCH option allows the user to create a “patch™ file 
consisting of only of those recors from a source files» which were 
changed during an editing sessiense Deleted records are saved in a 
patch fite as “£VOID" records. 


DURROUGHS CORPORATION COMPANY CONFIDENTIAL 
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tExampies 

SAVE 


Yhe workfile is savede 


SAVE AS AFILE 


The workfile is saved under the name AFILE. 
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SEQ 


oe ee eee 


The SEQ cammand invokes automatic sequence aodere causing the system 
to provide the sequence number for each new tine. With the 
exception of QCMARGIN}I>s and ? Ccontrot: characterdsr no commands are 
recognized in automatic sequence node. 


syntax: 


SE Qe ee etn e renee ae newman ee nn en nena teen on ean semen cn nano mnmn> 
- 1. 4 i 
jrceeenne> base steers es >} pew wewceeree> ting terererl 

i 

frenmerwee> NEXT oneeenene>] 


i etene 1 


25 we um 


NEXT * begin sequence numbers with Last output + 
INC from previous SEQ. 


END 3 begin sequence numbers with last record 
SEQUENT. 


Semantics: 


An initial value is assigned as the sequence numoer of the next 
line to be entereds the value is incremented for each subsequent 
Line. Initial values are specified by an integer <base> and <inc> 
or ty defaulting to values 100 for the <base> and 100 for the 
<inc >. If NEXT is specified>s the sequance numbering bagins where 
the Last sequence numbere for that users was terminated. 
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Sequence mode is terminated by entering end-of«text immediately 
following the sequence number or by transnitting back only the 
sequence number backe CANDE then displays a message at the 
terminal that the automatic sequence mode i5 terminated. 


SEQ will display extsting records in sequence with the new sequence 
numbers that have been created. Display will begin with the last 
record from previous input if pagesize $$ greater than onee BACK» 
SAME » NEXT» ™e and ¢ will terminate the S[5Q mode and display the 
requested page. For CRT devicesr the cursor is placed immediately 
after the sequence number of the first record.” Returning anty the 
first sequence number will terminate the command. Blank records 
will be added to the tanke MARGIN wilt nat be applied. 


Exanptles 


S 10410 


Enter automatic sequence mode using an tnitial and increment value 
of 10-6 


hm 


LF 
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SINGLE*LINE ENTRY 


WO GA AD wie OR) a ER WE OR Pe Ce mE Toe UR end CU ee 


Any line beginning with a digit of size = sequence fietd lengthsfor 
current file type» is a “conmand” to enter a new Line of text at 


the sequence number specified» or to replace or detete the tine 
already at the sequence number. 


SyYNLAKs 


Wh OO sD ED ER Oe DO ee ta ED ee) EO oF a a an ee am Sp <S> ROURKE te RE Te ey | 
~ 


1 I 


Semantics: 


The line consists of an integer sequence numbers <S>» followed 
immediately by an optional newtext field supplying the cantents of 
the new line. The sequence number begins in the first column of 
the input lines and runs until ai nonedigit character 1s 
encounterede or until the maximun number of digits for a sequence 
number have been entered? newtext field begins itn the catumn 
immediately followinge If there is already a Line of text at the 
specified sequence mumbarse that Line is replaced by the neuntext or 
blanks. 
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Examples; 


100 THES [5 A NEW LINE 
215 AND SO 1S THIS 
‘300 


{the above entry causes record 300 to be 
blanked cut but not deleted) 


fl 
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SPATCH 


th a a me 


The SPATCH command allows the user to insert up to ten characters 
of patch identification information inte cotumns 81°90 of the 
Wworkfile records for ali file tyees except "DATA". The command 
remains in effect until the user signs off from the current 
S@SSION. 


syntax: 


{re~> sequence range w74>! 


Semantics: 


A delinited text string of up to 10 characters is required with the 
“SPATCH commands and the sequence range is optional, If tha 
sequence range is omitteds then the delimited string is Saved as a 
permanent patch.id string and ts applied to future entries to the 
workfite. If the sequence range is includeds then the patch.eid 
string is treated as temporary and is immediately inserted tnto 
the workfite records specified by the sequence range. This tatter 
form of the SPAYCH command does not change any previcus pernanent 
setting of the patch.id. 


tt 


BURROUGHS CORPORATION COMPANY CONFIDENTIAL 

COMPUTER SYSTEMS GROUP RLBGO/1L7090 CANDE 

SANTA BARBARA PLANT PeSe 2212 5561 (8) 
TEACH 


The TEACH command provides the user with the capability of 
requesting an explanation of CANDE commands. 


symtaxs 


TEACH ee ee ee ee ee ee ee ee ee ey muwwn > | 
ss j j 
fae e> <COMMAND> ss2e=>] 


Entering YEACH without any specific command mentioneds wilt cause 
the system to return a complete List of valid CANDE commands and 
their valid abbreviations in form: 


<abbreviation> (<remaining Letters>) 


@egGet UPDATE wittl appear as: UPCDATE) 
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Entering TEACH <command> wilt cause the system to return three or 
more Lines of text and witht give ae full description of the 
semantics and syntax of the requested command. @eget TEACH UPDATE 


COMMAND? UPDATE 
SEMANTICS: CAUSES IMMEDIATE UPDATE ON THE WORKFILE 


SYNTAX? UPDATE 9) 0 9 ea See ONT RE AD A Ge UM OE ee Hr OE GD he ED OO AD OF OP DED a ee ee an yf 


BURROUGHS CORPORATION 
COMPUTER SYSTEMS GROUP 
SANTA BARBARA PLANT 


TERMINAL 


we on Os aw ce ew aT ee 
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The TERMINAL command will allow the user to specify or query the 
number of Lines per page or per screen for his terminals or to 
modify the output moda of the terminal. 
Syntax; 
os a me ae TERMINAL Gh Gh OD On me mb EER MP SE GN OH 2 OD Oe Oy FF ES OP A OM A) OU ER ct OH A HO ON OD Oa OD oe a OR we em oe ce > ff 
| ee ts EE e0 j-=> PAGE eee m amma mea aN mY OO DO oe > | 
-3- on ee l--<integer 1-22>--<--=>] 
[="> CONTINUQUS ss2ene nee en enn een een ene>] 
jor<-> WAL Tasewewane nanan ao wae oe A ah a ad ee ae Or ee oe | 
Semantics: 
PAGE specifies the number of tines per page or per screens as the 


integer page-length. 
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Default page sizes are? 


Device Terminal Type ; Page Size 
89350 Teletype ‘0 i 
1c Series 2le @23r Zhe» Cor Che ZT 1 
TO700 32 ; 2 
TOF 30 33 2 
TOSOL 4i 10 
TOHB02 42 22 
TDE21 43 10 
TDE22 4& 22 
T0831 45 LO 
TD832 46 . 22 


Note: Oefault page sizes are also maxiwum possibte values. 


If no parameters are specified then current page size and 
current output ‘sode are displayed. 


If PAGE LENGTH #5 not specified then the current value of page size 
¥5 displayed. : 


CONTINUOUS wilt cause the terminal to be left in *fTRECEIVE* 
unconditionally after each output if scrolti is enabled. 


WAIT is the default cutput mode and will cause the terminal to go 
to local after most outputse 


Notes = TO730 is treated as a TH7OdO 
~ YD830 series are treated as ThAZO*s excent for 
fastsetect and stop highlight character 
~ 70830 series running tuo*Hvire direct cannect 
should have the system adapter strapped 
for 15ms write-delay. 


Ww 
i 
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TITLE 


we we et FH a 


The TITLE command changes the name of the workfile or a file on disk. 


Syntax: 
TILL Soe ates sewer ser ees aso: FP Lehane. 2. SSR ote see eee ees aaa 
a ae I j 
[-er==> filenane 1 erent eee | 
j i 
t-eT0-=] 


Semantics: 


If <filename> is not specified» the name of the workfile is changed 
for-any subsequent SAVE command. 


The nane of the file <filenanme 11> is changed to <filename 2>» which 
must be a new file name within the user's Library. 


Example: 


TI ZAP 


Change the name of the workfile to ZAP. 


TITLE A TO B 


Change the file named A to Be " 
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UPUATE 


i ay op om aE 


The UPDATE command forces immediate update action in the workfile. 
It is not necessary that the user explicitly invoke this commands 
it is invoked automatically whenever the tank file in filled. 


syntax: 


UPDATE 6 a A OE REDE AE OS DY OD EH AY ED NN ey A ED OY OY OH ED CH WO rE ey A a oH aD ee a oe ew te me YF 


Semantics: 


UPDATE forces all the changesf/additions in the tank to he 
incorporated with the workfile. Jf the tank ts emnatys the UPDATE 
has no effect. 
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Yhe WHAT command indicates the state of the workfite. 


Syntax: 


WHAT 1 0 eS FOO aan a ny POS Ely Ae OPE EG EN We a CY HE On EE CO Te ED OO ee Om ee Ya a SR em ee ec > P 


ma eB 62 HD 


Semantics? 


The amount of information provided varies depending on the current 


state of the workfile 


. 
P 


as much information as is availabte is 


indicated. Qutput may include: 


TITLE 

TYPE 

MARGIN setting 

SAVEdG or unSaAVEd status 
BEGIN SEQ NO: of file 
ENDING SEG NOs of file 
SGURCE FILE SIZE: <N> 

TANK & HORKFILE SIZE tCincluding detetes}s <N> 
TIME = CANDE processor tine 
SGURCE PACK ID 

PATCH ID 
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TITLE: <filename> 
TYPES <file type> 
HARGIN SET AT <integer>» 
WORKFILE IS SAVED/SUNSAVED 
BEGIN SEQ NOS <integer> 
ENDING SEG NO? <integer> 
SOURCE FILE SIZE: <integer> 
JANK & WORKFILE SYZE? <integer> 
Cincluding detetes) 
TIME = “HHS MH2SS.7T> 
SOURCE PACK ID = <PID> 
PAYCH ID = <character string> 


a7oC 


aa 
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WHERE 


oo) OM en 


The WHERE command provides the <isn> of a user. 
Syntax: 


®WHERE Oe ee re usercade 2 AD > wh OE em aD OD GR A eR OD OE ee om A women > | 


“<< i a 
fomeen> ALL meeawe] 


Semantics: 


provided? otherwise the user is so notified. The ALL option gives 


If the specified usercode ts "is" So np Loaged-on then his <tsn> is 
th <isn> of ati users currently Logged=on to CANDC. 
i 


= 
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WRITE 


Te OE ih oR eS 


The WRITE cammand prints to.the printer or punches to the card 
punch the contents af the workfile or some other file. Options are 
available for selecting specific Lines or calumns. 


Syntax; 
aaa a a aaa ad soot 
aa & j ee eee ea ee ee ee eee See eee 1 
LeeLee Ses > FE Lena a Sats eS eS ase ee SSeS >! 
1 T->«-] L=23> fy pererrs4 
Peet oes Sequence ange -=-s=--—== Taira ee 
Peel} eeren-> coluan range a aa aga a >t 


fe-( Lessee e> Tee PRINTER Heer nse awomeaniammm> | 
Joo wes eeee ft . 
H { 
i-> CARDS ee | 
i = <2 oa eo { 
f-~> PRT <>! 
i ome i 
i--> CRD ==>] 


ES eee GS 


Semantics: 


By defaults the contents of the workfile are printed. If a 
<filename> is specified>s and the user has access privilejese or if 
the file is publice it is usede A sequance range and a column 
range may be specifieds otherwisee the uhole file and the entire 
line are printad or punched. The terminal shows the user sees how 
many records were printed or punched. _ 
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This command should ba used in conjunction with the autoprint 
routine tn the MCP. If the autoprint option is set» WRITE 
generates a backup file that will be printed or punched when the 
autoprint routine gets to the backup file. 


Examples? 


WRITE | Writes to the line printer all records 
in the user®s current workfile. 


WRITE A TO CARDS Writes to the card punch atl records in 
<DEF oPACK>/C UC) S Aw 


WRITE LOG-1000 TO PRINTER Writes to tine printer recerds 100 
through 1000 inclusive. 


WRITE *CUCO/A Weites to the Line printer all records 
in file CUCISA. 


Note: The autobackup printing facility cannet be utilized by CANDE 
CANDE ¥6 not excuted under a usercode. 


-2<MCP centrel string> 


2 a Te am ce sys OB ER By 6 ty ve RX A a ae mm ER WR oe 


A question mark tn column onee Line one of input followed by any 
string whose first token is not a valid CANDE control command wiit 
be sent to the MCP. If CANDE Ys running under ao privileged 
usercede/passwords the MCP response will return to the terminat of 
the inttiating user. 


fay 5 
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OPERATOR INSTRUCTIONS 


9 SH RY AR AD SS OY A Oe ie SR OD UH ER OD eh GN ete 


This section is tntended to provide the host system operator “for 
CANDE with facts to help execute and naintain the CANDE systen. 


Those topics discussed will be the execution of CANDEs the use of 
the network controllere and options available to the operator for 
the maintenance of thea CANDE system. 


The operator should have available for his use capies of 3 


Burroughs 81700 Message Control System Information Manual 
Burroughs BL700 Network Definition Language Information Manual 
Burroughs B1700 Software Operational Guide 

Burroughs BL700 CANDE Information Manuak 


EXECUTION OF CANDE 


ah Oh wh ee ae a OE Ge CS CE a CR SP CE EE KH Cs 


To use the CANDE systems Che operator executes CANDE. CANDE will in 
‘turn executes the network controtler if possibile see nelow}. Beth 
CANDE and the network controller should execute at a higher 
priority than other prograss in the mix to insure adequate 
response times to the user. 
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Upon execution CANDE will determine if recovery is appropriates and 
if $0 will build individual user recovery files for the previous 
CANDE sesStons. CANDE will then condition its working files for the 
nen S@Ssione 


Finally» CANDE wilt execute the network controller if the foltowing 
conditions are true: 


The network controller must be presente a valid code files 
nor currently executinge and named “CANDE/KANDLER”™ either 
on system disk of on the same user disk from which CANDE 
Was executed. 


Program Switch QO» tin CANDE>» must he setr 1.468.» greater than 
“7ePrae 


If the network controlter cannot be found or was not executed du 
to any reason other than SW 0 eaual to zeroes the ocperator with ode 
nacified Via the SPO. Any Gesiread netuork controtitler can then 95 
axecuted. Note that by setting CANDE*s program SWitch 30 to zerar a 
file named "CANDE/HANDLER®™ can reside on disk and CANDE wiit not 
attempt to ZIP™execute ite 


Nete: If a hangler exists in the name table and CANDE 7ZIPrexecute’s 
a handler a DS situation could occur because of more than ane 
handler being executed. € see pge 4°3 3 


FILENAMES 


. 
we ae CN a oh We a Oe 


Fites created or loaded by CANDE appear toe tha user to have but 
one filenane up to nine characters in Length. To the CANDE 
program though» the files are named by the convention of 
usercode/filename. By doing this a certain amount of file security 
is provided in the systeme and the hazard of two users creating 
files of the same name is elininated. A user may have read-only 
access to another user*s files if he its certain the userts 
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usercode and his own are both privileged. 


If aouser wishes to GETse MERGE» RMERGE» FINDe LIST or INSERT from 
another user's file he must specify the usercode/filename saction 


of the multi-fite-id in the command syntax. 


SPO Options 


CANDE allows. communication between terminals themselves 
terminals and the system SPO for vice versa}e Messages 
the terminal will appear as: 


USER = <isnm>2<textuat messaga> 


The operator can tatk to the terminal by entering: 


<CANODE mixtindex> AX <usercode> <message> 
or 


and between 
coming fron 


<tsn of destination terminai> <message> 


EXAMPLES 


ZAX JOHN WHAT FILE ARE YOU USING? 
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The 


system operator has certain commands that can be directed ta 


CANDE. These commands are *°WHO. “8STUP".» ALL" and "HAKE"*. The 
"WHO command witl print a list of usercodes and associated 


Logical station nuabvers that are currently Logged-on the system. 
The command *STQP" will bring CANDE to a Logical conclusion. Thts 


command will only be executed if there are no users floggedson the 
Systeme The "ALL? command atlows the operator to broadcast a 


mess 


the 


The 


aga to all terminals. Yhe command *MAKE® ts provided to attiow 
operator to make a station "READY" or "NOY READY*. 


MAKE 


2 OR 


Syntax: 


PeNnOT~1 


"ready" flag in the network controtter's table for the 


specified isn will be changed as requested. 


STOP 


mE Oe oe 


syntaxs 


fe-cn ninutes>~>!] 


6-5 


BURROUGHS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP BLBO0/1700 CANDE 
~ SANTA SARBARA PLANT PeSs 2212 5561 (0) 


Semantics: 


<CANDE*S mix> AX STOP <n> 


The STOP commands for automatic shutdowns provides for controalied 
shutdown of the CANDE system within <n> minutese with <n> being 
eptionats anda default of 2). When entered at the SPO» the 
command causes the following: . 


If no users are Logged~one CANDE goes to EQS. 


Each logged-on user is sent tne following message: 


CANDE WILL STOP IN <n> MINUTES. PLEASE SAVE OR 
REMOVE ANY ACTIVE FILE AND LOG-OFF. 


is reported at the SPO (Cas 


At the same time each Logged-on n 
ns are reported the fotilowing 


4 
before). After all tlogged-on L 
message is displayed at the SPO: 


3 
$ 


CANDE WELL ADVISE AUTOMATICALLY AT <hhemasss.t> 
IF USERS ARE STILL ACTIVE> 


From this point one only the following commands are allowed: 


Control commands (°?*3 


RECOVER UPDATE BYE 
REMOVE WHAT DCSTATUS 
SAVE RESEQ FILES 
TEACH 


One sore page of input records wtti be processed so that a page in 
the process of being edited when the STOP occurs will not be tost. 


Note that no further *singlesline’ input (is allowed» 
except when that Line comes from a device with a pagesize 


of Le in which case it is treated as ‘one more oage of 
input records’ as above. 


ALL other commands will receive the following response: 
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CANDE TERMINATION IN PROCESS. PLEASE SAVE OR 
REMOVE ANY ACTIVE FILE AND LOGOFF. 


if <n> minutes elapse and there are stili users togged-on» the 
following message is displayed at the SPO: 


SHUT DOWN TIME HAS ELAPSED WITH USERS STILL ACTIVE. 
CPERATOR ACTION REQUIRED. - 


None of the above conditions change except that CANDE will not 
advise the operator again. 


The automatic shutdown function ts intended for the system 
operator’s conveniences not a user inconvenience. To that end> 
CANDE will never shut itself down while users are active. I[t 1s 
the raspansibility of the usere howeveres to flog-off when no 
activity i195 anticipated for a while. 
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CANDESHANDLER 

BASIC 


The interactive BASIC implemented for 81709 CANDE is iitke that on 
the BOo7O0 CANDE.’ The user creates his filer then enters COMPILE» 
RUNe or EXECUTEe and CANDE handles all file equations for the 
taske To make use of interactive SASICs a naming convention must 
be followed in the NOL handler that tis generated» the filename for 
the statton must be "“F" CAT <station name> and this name must not 
exceed four characters on COMPILES» RUNS» and EXECUTES of BASIC 
files. 


SCROLLING 


TD6Z20/830 series devices are capable of strolling. Scrolting is 
enabled by entering a "*?7+#S" and disabled by "2°85". In SECROLL moder 
att entries are made on the top Linge but the entries are rolled 
to the bottom of the screen and the responses come hack from the 
bottom upe “?#S" entered on devices that do not scrott will 
generate the response “NOY A SCROLLING DEVICE". Ta correctly 
determine the type of terminate users must observe the following 
conventions when compiling a network controller to run with CANDE: 
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TERMINAL SECTION 
See the YERMINAL command (€ page 5°56 ) for valid cerminaltypese 


Also implemented itn CANDE"S request~-and-control section Is an 
output message control procedure which prevents output messages 
destined for a station that ts tin locale or otherwise unaole te 
accept the messages from neing retried indefinitely. After tuo 
tries» the outout message is suspended until any one of the 
following occurs: 

ie 30 seconds elapse with no transmissions from the station. 

Action: Message is tried again as above. 
2. User transmits something other than "%?". 


Action: Suspended output message(s) retried alsot input is 
sent to CANDE« 


3. User transmits "?". 

Action? Suspended output retried and "?" not sent to CANDE. 
4 User transmits iy os 8 a 

Action? Flushes queued output to a depth of "MAX MESSAGES® 


as defined in the compited handler. Oefault iif not 
explicitly set is 20. 
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This procedure pravents denied output messages fron taking over the 
processor. The network controller executed with CANDE should be 
compiled using "NDL/LIBRARY™ requests and controls selected from 
the following: 


REQUESTS CONTROLS. : TERMINAL TYPE 
CANDEPOLTD § 

CANDESELTO fernesenre-24 CANDETDCTL wwee-e-! TD SERIES» TC SERIES 
CANDEFSLTD 1 


CANDELOUVITY . seesssee== CONVERCT).. ster Sesee = ike TELETYPE 


These requests inctude a number of functions specificatly tailored 
to the output produced by CANDE in order to opravide a e*more 
readable output at the terminal and to ensure recovery under 
terminal failure situationse See Anpendix A (Section 7) for 
further information. 


Other requests may be used with CANDEs howeverr results may be 
undssirabile. 


CANDE/ANALYZER 


BROW EN A Ba ODE OO a 8 ot 


CANDEZANALYZER 58 a companion program to BifOG CANDE and is 
intended primarily to aid in debugging CANDE. In an interactive 
realtime program such as CANDEs bugs can exist which becone 
evident only upon entering some unusual sequence .af commands or 
which involve a particular interaction between two or more users. 
When such bugs occurer it is typically difficult or impossible for 
users to know precisely what they did that caused the CANDE 
failure. CANDE/ANALYZER should hetp resotve this problem. 
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At ®8®QJ- CANDE creates a trace file catlied CANDE/SAUDIT and writes 
inforzcation about each USER/SCANDE transaction i Into that file. 
CANDEAUDIT is taid out to minimize the time required to create 
the trace and is not easily read by the users. CANDESANALYZER then 
assumes the burden of reading the audit file and of breaking tt 
down tnto a format easily read by the usere 


CANDE/ANALYZER is released with its program switches set to: produce 
the most useful outout for depnuagging purposes. This setting 1s: 
Sw=s00000210193. It may be modified to any other vatue. 


For more information about CANDE/SANALYZERe see PeSe 2219 O185>% 
CANDESANALYZER.4 
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APPENDIX A 


Bh 6 ah a 4 GR TR ae AD 


NETWORK CONTROLLER 


Compilation 


Following is a source Listing of a typical handter to be used with 
CANDE. 


File configuration allows user programs to open remote fites to 
their own terminal without affecting operation at other terminals. 


For example» user “A™ at LSN“1 Cstation name = "ST1"s available in 
file named “FST1I" may execute a program which opens a remote  fite 
named "FSTi". The program will then automatically be attached to 
the. terminal from which the user executed the job through CANDE. 
Note that the BASIC system requires that a file which it is to 
open be named “F" concatenated with the station name Cin this case 
"STi" and that the total number of characters involved in forming 
this file name be no greater than four. 


Application programs executed via CANDE need not ensure that the 
remote file name that is opened exists in the handter. The OPEN 
will be passed to the spawning job (CANDE in this case) if a file 
name match cannot be made. CANDE will approve the OPEN as long as 
ali stations Cexcept that from which the execution originated) ares 
not logged-on to CANDE at the time of the OPEN. 
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Operation 


The requests specified in Section "CANDE/HANDLER™ initially 
determine if the stations opened are on-line and responding. Those 
that are not will be automatically deleted from the poti tist for 
8 minutes to be restried on an 88-minute cycle. Switched tines will 
remain ina “waiting for ring™ state. If leased or direct terminal 
is inuse with CANDE and experiences failure» such as many 
consecutive timeouts» toss of data~set*ready» or toss of carriers 
the terminal is then deleted from the poll List. 
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If a switched terminal is disconnected or the Line is disconnected 
in any ways then the network controller will reinitiate a “wait 
for ring” state on the line and CANDE will recover all appropriate 
data and will leave the station “"*ready™ for the next dial-in. 


Reconnecting a direct or leased terminal will not automatically 
cause the network controller to recognize and service ite The 
operator must enter a MAKE command at the SPO in order to make it 
ready immediately. If he does not make it ready» it witl be 
re-tried after a maximum of eight minutes... 


Resdialing from a switched station will cause immediate service 
when connected. 


After failure has occurred and_ the user has successfully 
reconnected» he must logon againe At that time he wiil obe 
advised of any recovery data he may have. . 
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TTTELEALELELESEETELELEStE TEL te EAS eeeLeteTeeteTTett tte ee Tee tee tere Tyee: 
x% Z% 
X% DECLARATION SECTION x2 


a2 
RXXAR ALAR RAZ ALA AL ALAA LALLA LULA ALA LAT YAH LLA LA LLEL LE LZ LL ALE LU REALLY ERD 
: 


DECLARATION: 

NIF="CANDE*/S"°NIF "2% 

MAX BUFFERS = 52% 
MAX MESSAGES = 25546% 
Z ‘ 
z 
RARER AEUAKAR ARAL RZ AAA AREA AAA RAAT LL AREAL LEME NEL E LLL EAA LA AED 
az Xz 
2% REQUESTS & CONTROLS y & 4 
az 4 


RARER AR EAAA UREA RRAEARAZRARR EAA ALARA ARAL RR ARL AREAL A NAA LARA AL AAA LAA RAE 
SLIBRARY CANDEPOLTD % 

SLIBRARY CANDEFSLITO 2% 

$LIBRARY CANDEIOTTY 2% 

SLIBRARY CANDETDCTL 2% 

SLIBRARY CONVERCTL & 


XAERALRA RAL AA LAL AALAAAALAAAALAL ALLA LA AL AU AALL ALAA AULA ALLA LLEKAL LALA ARLAY 


22 ro 4 
2% . NETWORK CONFIGURATION x2 
x% . x2 
RARER LK LUKE ALARA ALLL ALAA AAA AL ALARA LA AAU Z LALA ALAR AAA ALAR EARL ALLAN 
xz x2 
2% | TERMINAL SECTION z% 
2% x% 


SSLESTSETESTTESSERESTEETETTETTTTETTTETEETTTTETETTRTTTETTETEEETETTETTEE 
TERMINAL DEFAULT TOFLTs: 


REQUEST = CANDEPOLTD: RECEIVE x 
CANDEFSLIDS TRANSMIT > r A 
TRANSMISSION = O-« 
ADDRESS = Ze 
TYPE = 4he% T9822 
BUFFERSIZE = 2250«% | 3 
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TERMINAL TD8222% 
DEFAULT 
TTY: 

REQUEST 


TERMINAL 


TRANSMISSION 
ADORESS 

TYPE 
BUFFERSIZE 
TCS: 

DEFAULT 

TYPE 
BUFFERSIZE 


TERMINAL 


it 


buon i 


ee 


T=5 
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TOFLT. 


CANDEIOTTYSRECEIVEs & 
CANDELOTTY2 TRANSMIT» & 
0. 
0. 
0.% TELETYPE 
150.% 


TDFLT 
252% €YC3500 SERIES) 
225 0% 
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LEX LAL L LLL ALLA ALL ALLEL LLL LLL LLL LEILA 


2% x2 
a2 STATION SECTION x2 
4% xz 


SUTtSAtEs ise iseeec cect eceetesteteeleCcecceeeeceseeeteceeeeteececee esis 


STATION DEFAULT YOBDF: &% 
FREQUENCY = 2, 24 
MYUSE = INPUT» OUTPUT. 
TERMINAL = D822. % 
RETRY = 4e2 
STATION DEFAULT TTYOF: 2% 
FREQUENCY = 2» 242% 
MYUSE . = INPUT»OUTPUT.2 
TERMINAL = TTY.% 
RETRY = 4.2 
Zz 
STATION ST12 2% 
DEFAULT = TDBDF. % 
- ADDRESS = D1". 
STATION ST2: 2%. 
DEFAULT = TD8DF. 2% 
ADDRESS = "D2". 
STATION ST3s 2% 
DEFAULT = TD80F. % 
ADDRESS = "D3". 
STATION ST42% 
DEFAULT. = ITD8DF.% 
ADDRESS = "D4".% 
STATION ST5:22% 
DEFAULT = ID8DF.2% 
ADDRESS = "R32 
STATION ST632% 
DEFAULT = TIDSDF.% 
ADDRESS = "R422 
STATION ST722% 
DEFAULT = TDSDF.% 
: ADDRESS MRO 
STATION ST82% 
DEFAULT = TTYDF.% 
ADDRESS = "007.2% 
STATION ST92% 
DEFAULT = ID8DF.% 
TERMINAL = TCS.% 
ADDRESS | = "LA" 
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MULL ALL VAL ALAA L LAU ALANA ALAA ALL LLL LLL LULA A LLL ULLAL LL ULLAL LAK 


Xx LX 
2“ LINE SECTION LX 
1% | L% 
TELESESLSEESSSESSSESOSESLE SSE SES ESSE SESE SSESOSSSSSS TEESE ESSE SEES SS ESS! 
LINE DEFAULT LINEDFLT: 

CONTROL = AUTOPOLCTL.% 
x 
LINE DIRECTOL: 

DEFAULT = LINEOFLT. 

AUTOPOLL = 35.% 5 PER STATION 

ADDRESS = 12026.% 7 

STATION = STLoST2oST3eST4eSTSeSTGrSTTe 2% 
LINE SYNCOL=% 

DEFAULT = LINEDFLT.Z% 

AUTOPOLL = 5.% 5 PER STATION 

ADDRESS = 120322.2% 

STATION = $TL1.% 
LINE TTYO12% 

 - DEFAULT = LINEDFLT.% 

CONTROL = CONVERCTL.% 

ADDRESS = 12029.2% 

STATION = $T8.% 
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pS iy & & @ SBOE EES SSPE S OS SS GESTS SS PTET Te OST T SETS ESSE ESTE Se ee eee e eT eT TOOT ees: 


a x% 
res ‘ FILE SECTION xz 
xk Aa 


RLLULALLEMLALLAAAALAL URAL ALE RA RE LAAL ALLELE ALA ALA RAEL ALLEL AREAL UKALAL LAL 
FILE CANDEQUEUE: % 


FAMILY = STLieST2eST3eST4sSTSeST6eST7e>STS8eSTIn 2% 
FILE FST1: 2% 

FAMILY = ST1.2% 
FILE FST2:3 2Z 

FAMILY = $T2.2% 
FILE FST3: & 

FAMILY = $173.2 
FILE FST4: &% 

FAMILY = $T4.% 
FILE FSIS: <% 

FAMILY =z S§T5. 2% 
FILE FST6: % 

FAMILY = $T6. % 
FILE FSYT72% 

FAMILY = $ST7. % 
FILE FST8s % oo 

FAMILY = S$T6.% 
FILE FST9s 2& 

FAMILY = S$T9.% 


EET ELLA LAA ALAA RE LAUREL ALAA RARER EEL AMER AAR 
FINI. 
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Terminal Options 


Terminals other than those specified in the CANDE/HANDLER' sections 
if connected to the CANDE system may not operate correctly with 
the specified requests» although any Burroughs* qualified terminal 
for the BL700 can be connected to the CANDE system via a user 
coded request which could include the special features built into 
the released CANDE requests. 


CANDE makes use of certain control codes to effect a more readable 
outpute Terminals should be so optioned when setup: 


J0D3 (CR). 9254 (LF)>» 20C2 (DC4)> 

33C2 CHOME ONLY)>+ aia (DC1)> 3132 (€0C3) 

3272 CESC)» 9189 (CAN)> ~ a0Fa (S1)-(TD820 Series) 
OR 


@1E3 CS1)-€TD830 Series) 


CANDE 


CANDE Processor Time 


A value calied "TIME" appears on the screen whenever WHAT» BYE» or 
HELLO Ys transmitted. This value is the amount of time the user 
spent being serviced by the CANDE system. This time will be tess 
than the difference of tog~on and Log-off times except after 
recovery when the previous session's time is taken as a starting 
time. 


The time value is not strictly hardware "CPU" time. It includes [0 
times both datacomm and any disk accessing. Included also are such 
System overhead costs as overlayer service requests» rollin/rollout 
of the users» and others. ; 


7-10 


BURROUGHS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP Bis0O/17090 CANDE 


SANTA BARBARA PLANT PeSe 2212 5561 (B) 


It is not intended to be used directly for billing» but it is an 
indication of the amount of time the CANDE system spent in 
servicing the user. 
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ALPHABETIC INDEX 


2<MCP control string> 
APPENDIX A | 
BREAK 


CANDE EXECUTION 
CANDE MECHANISMS 
CANDE/ANALYZER 
CANDE/HANDLER 
CLEAR QUEUE 
COMMANDS 

COMPILE 

CRI“TYPE DEVICES 
DATA FILES 
DCSTATUS 

DELETE 

DISK PACK DEFAULTS 
“DISPLAYS AND ERRORS 
DS 

ENTERING DATA 
ERROR MESSAGES 
EXECUTE/RUN 
EXECUTION OF CANDE 
FILE POSTTIONING 
FILENAMES 

FILES 


FIND 

FIX 

GET 

HELLO 

INSERT 
INTRODUCTION 
LINE DELETION 
LISf 

MAKE 


MARGIN/@ 

MERGE/RMERGE 

MOVE 

NETWORK CONTROLLER 
OPERATING PROCEDURES 
OPERATOR COMMANDS 
OPERATOR INSTRUCTIONS 
PAGE 

PASSWORD 

RECORD MODIFICATION 
RECOVER 

RECOVERY 

RELATED DOCUMENTATION 
REMOVE 

REPLACE 


Wi 


re ee ee | 
on a 


& WN 


Wi 
é 
On 
— 
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RESEQ 

RESPONSES 

SAVE 

SCROLLING 

SEQ 

SEQUENCE NUMBERS 
SINGLE*LINE ENTRY 

SPATCH 2 
SPECIAL CONTROL CHARACTERS - 
$s 

STOP 

STRUCTURE OF THE USERCODE FILE 
SYNTACTIC VARTABLES 

SYNTAX CONVENTIONS 

SYNTAX DIAGRAMS 

SYNTAX SPECIFICATIONS 
SYSTEM/MAKEUSER EXECUTION 
TEACH 


- TERMINAL 


TITLE 

UPDATE 

USERCODES AND SECURITY 
WHAT 

WHERE 

WORKFILE 

WRITE 


